Вопросы о документировании вложенных массивов и данных объекта с помощью jsDoc

Как форматировать вложенные массивы и объекты с помощью jsdoc?

Это мое лучшее предположение:

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);

Как указать, что объект индексируется какой-то строкой?

Как определить вложенный массив?

Также не уверен, куда помещать квадратные скобки в необязательный параметр.

Ответ 1

Я бы рекомендовал проверить этот. Я бы, вероятно, написал бы что-то вроде этого:

//{Object{username:<Array<Object{param1:String, param2:String,[optional_nest]:string}>>}}

Ответ 2

Вы можете попробовать сделать это следующим образом: (как указано здесь http://code.google.com/p/jsdoc-toolkit/wiki/TagParam)

/**
* @param {String[]} obj.username.array
*/

Предполагается объявить obj.username.array как массив строк. Вы используете jsdoc или jsdoc3?