Array.<number>还是Array<number>？

Question

数组表示法的正确JSDoc格式是什么？

Array.<number>或Array<number>

我见过这两个词可以互换使用，不知道是否有区别。

另外，当涉及到Promise<number>时，我可以使用Promise.<number>吗

Answer 1

闭包编译器使用Array<number>。可能其他风格的JSDocs更喜欢Array.<number>，但我还没有用过它们。

例如：

/**
 * Sorts an array of objects by the specified object key and compare
 * function. If no compare function is provided, the key values are
 * compared in ascending order using <code>goog.array.defaultCompare</code>.
 * This won't work for keys that get renamed by the compiler. So use
 * {'foo': 1, 'bar': 2} rather than {foo: 1, bar: 2}.
 * @param {Array<Object>} arr An array of objects to sort.
 * @param {string} key The object key to sort by.
 * @param {Function=} opt_compareFn The function to use to compare key
 *     values.
 */
goog.array.sortObjectsByKey = function(arr, key, opt_compareFn) {
  goog.array.sortByKey(arr, function(obj) { return obj[key]; }, opt_compareFn);
};

Via - https://github.com/google/closure-library/blob/master/closure/goog/array/array.js#L1194