jsdoc two dimensional array

Question

I have an array of array of string and I can't figure out how to document that with JSDoc.

/**
@class
*/
function PostbackList() {
    /**
    @type {int}
    @default
    */
    this.TypeID = 0;
    /**
    @type {PostbackList.Field[]}
    */
    this.Fields = new Array();
    /**

    !! Issue here !!


    @type {string[][]}
    */
    this.Values = null;
}

Which results in errors.

Invalid type expression "string[][]": Expected "!", "?" or "|" but "[" found.

And I don't know if I should put ? in front of the type to indicate it can be null.

I just tried mixing different syntaxes together and '@type {Array.}' works. But if there's a way to just use '[]' it'll be nice to know. — Serge Profafilecebook, Sep 01 '14 at 09:48
Maybe make a function that doesn't have such a complicated API :P — maček, Sep 01 '14 at 09:54
Are two dimensional arrays being deprecated for best practice? O_o — Serge Profafilecebook, Sep 01 '14 at 09:55

score 26 · Accepted Answer · answered Sep 01 '14 at 16:18

According to what the current maintainer of jsdoc says in this issue report, as we speak jsdoc 3 cannot handle declaring multidimensional arrays by adding square brackets. You can do it like you did with Array.<string[]>, or with Array.<Array.<string>>.

According to the issue report, version 3.3.0 will allow the notation you wanted to use.

score 1 · Answer 2 · answered Oct 16 '20 at 10:24

1

Louis answer is valid, but the maintainer updated the repository and now also the code you provided is valid:

@type {string[][]}

answered Oct 16 '20 at 10:24

YarnSeemansgarn

21
2

jsdoc two dimensional array

2 Answers2