Bagaimana cara menentukan array objek sebagai parameter atau nilai kembali di JSDoc?

Di JSDoc, dokumentasi terbaik yang dapat saya temukan menunjukkan menggunakan berikut ini jika Anda memiliki array dengan tipe tertentu (seperti array string) seperti:

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

Bagaimana Anda mengganti tanda tanya di bawah ini dengan menentukan sebuah array objek?

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

Anda harus lebih spesifik apa yang Anda maksud dengan JSDoc - ini adalah istilah umum yang mencakup hampir semua alat dokumentasi bergaya JavaDoc untuk JavaScript.

Sintaks yang Anda gunakan untuk larik string terlihat seperti yang didukung oleh Google Closure Compiler .

Menggunakan ini, array Objek akan menjadi:

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

Atau hanya serangkaian apa saja - ini seharusnya bekerja dengan hampir semua alat dokumen:

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

jsdoc-toolkit , JSDoc 3 , dan JSDuck mendukung sintaks berikut untuk menunjukkan larik objek:

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

EDIT

Jika Anda mengetahui kunci dan jenis variabel dari nilai, Anda juga dapat melakukan:

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

atau

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