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);
};

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