Yuvalanmış dizileri ve nesneleri jsdoc kullanarak nasıl biçimlendiririm?İç içe geçmiş dizi ve nesne verilerini jsDoc ile belgeleme hakkında sorular
Bu benim en iyi tahminim:
an_obj = {
username1 : [
{
param1 : "value 1-1-1",
param2 : "value 1-1-2",
optional_nested : "1-1--2"
},
{
param1 : "value 1-2-1",
param2 : "value 1-2-2"
},
],
username2 : [
{
param1 : "value 2-1-1",
param2 : "value 2-1-2"
},
{
param1 : "value 2-2-1",
param2 : "value 2-2-2",
optional_nested : "2-2--2"
}
]
}
}
/**
* A function description.
* @param {Object} obj
* @param {Object} obj.username This is not the object name, but a name type.
* @param {Array} obj.username.array Desc... using [] would conflict with optional params.
* However this could be confused with an object called array.
* @param {String} obj.username.array.param1 Desc... This is the object name rather than a type.
* @param {String} obj.username.array.param2 Desc...
* @param {String} obj.username.array.[optional_param] Desc...
*/
var myFunc = function(obj){
//...
};
myFunc(an_obj);
nasıl bir nesne dize bir tür tarafından dizine belirtmek mı?
Yuvalanmış bir diziyi nasıl tanımlarım? Ayrıca, köşeli parantezleri isteğe bağlı parametreye nereye koyacağınızdan da emin değilsiniz.
Bağlantı bozuk ve yukarıdaki örnek jsdoc 3.3 –