JSDoc'da parametre veya dönüş değeri olarak bir nesne dizisi nasıl belirtilir?

JSDoc'ta, belirli bir türde bir diziniz varsa (örneğin bir dizi dizesi) aşağıdakileri kullanmak için bulabildiğim en iyi belgeler:

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

Aşağıdaki soru işaretlerini bir nesne dizisi belirterek nasıl değiştirirsiniz?

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

JSDoc ile ne demek istediğinizi daha spesifik olmalısınız - bu, JavaScript için hemen hemen tüm JavaDoc tarzı dokümantasyon araçlarını kapsayan genel bir terimdir.

Dizeler dizisi için kullandığınız sözdizimi, Google Closure Compiler tarafından desteklenen sözdizimi gibi görünüyor .

Bunu kullanarak, bir Nesne dizisi şöyle olur:

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

Veya herhangi bir şey dizisi - bu hemen hemen tüm belge araçlarıyla çalışmalıdır:

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

jsdoc-toolkit , JSDoc 3 ve JSDuck , bir nesne dizisini belirtmek için aşağıdaki sözdizimini destekler:

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

DÜZENLE

Değerlerin anahtarlarını ve değişken türünü biliyorsanız, şunları da yapabilirsiniz:

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

veya

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