Come specificare un array di oggetti come parametro o valore restituito in JSDoc?

In JSDoc, la migliore documentazione che posso trovare mostra di utilizzare quanto segue se si dispone di un array di un tipo specifico (come un array di stringhe) come:

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

Come sostituireste i seguenti punti interrogativi per specificare una matrice di oggetti?

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

Dovresti essere più specifico su cosa intendi per JSDoc: questo è un termine generico che copre praticamente tutti gli strumenti di documentazione in stile JavaDoc per JavaScript.

La sintassi che hai utilizzato per l'array di stringhe è simile a quella supportata da Google Closure Compiler .

Usando questo, un array di oggetti sarebbe:

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

O solo una serie di qualsiasi cosa: dovrebbe funzionare praticamente con tutti gli strumenti di documentazione:

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

jsdoc-toolkit , JSDoc 3 e JSDuck supportano la seguente sintassi per denotare un array di oggetti:

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

MODIFICARE

Nel caso in cui conosci le chiavi e il tipo di variabile dei valori puoi anche fare:

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

o

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