如何在 JSDoc 中指定一个对象数组作为参数或返回值？

Question

在 JSDoc 中，如果您有一个特定类型的数组（例如字符串数组），我能找到的最佳文档显示使用以下内容：

/**
 * @param {Array.<string>} myStrings All my awesome strings
 */
 function blah(myStrings){
     //stuff here...
 }

你将如何替换下面的问号指定一个对象数组？

/**
 * @param {???????} myObjects All of my equally awesome objects
 */
 function blah(myObjects){
     //stuff here...
 }

Answer 1

您应该更具体地了解 JSDoc 的含义 - 这是一个通用术语，几乎涵盖了所有用于 JavaScript 的 JavaDoc 样式文档工具。

您用于字符串数组的语法类似于Google Closure Compiler 支持的语法。

使用它，对象数组将是：

/**
 * @param {Array.<Object>} myObjects
 */

或者只是一个数组 - 这应该适用于几乎所有的文档工具：

/**
 * @param {Array} myArray
 */

jsdoc-toolkit、JSDoc 3 和 JSDuck 支持以下语法来表示对象数组：

/**
 * @param {Object[]} myArray
 */

---

编辑

如果您知道键和值的变量类型，您也可以这样做：

/**
 * @param {Array.<{myNumber: Number, myString: String, myArray: Array}>} myObjects
 */

或

/**
 * @param {{myNumber: Number, myString: String, myArray: Array}[]} myObjects
 */