如何在JSDoc中记录数组解构参数

Question

给定以下代码，如何使用最新的JSDoc正确记录它？

function docMe([foo, bar = null, baz = 1]) { 
  /* */ 
}

我尝试过这个：

/**
 * @param {Array} options Array containing the options.
 * @param {HTMLElement} options[0].foo An HTML element.
 * @param {Object} [options[1].bar] An object.
 * @param {Number} [options[2].baz] A number.
 */

显然这不起作用，JSDoc留档提到的只是如何记录去结构化对象参数，而不是去结构化数组参数。

Answer 1

在撰写本文时，闭包编译器中存在一个尚未解决的问题。

该线程产生3个不完美的解决方案：

1： JSDocs3的@param：

/**
 * Assign the project to an employee.
 * @param {Array} param1
 * @param {string} param1.foo
 * @param {*?} param1.bar
 * @param {number} param1.baz
 */
function docMe([foo, bar = null, baz = 1]) {
    // ...
};

2： 报告使用VSCode（我不是用户，因此无法确认）

/**
 * @param {[foo, bar, baz]: [string, *, Number]} param1
 */
function docMe([foo, bar = null, baz = 1]) {
  // ...
}

3： 对于闭包编译器：等待问题得到解决，然后使用该格式。它显然正在等待修复，并且未被阻止，因此希望它很快得到解决。