javascript - WebStorm 中针对参数数量可变的函数的正确 JSDoc 注释？

Question

我已经阅读了很多关于这个问题的答案，并且自己也尝试了一些不同的变体，但到目前为止，我还没有找到令 WebStorm 满意的答案。有问题的代码看起来像这样:

var slice = Array.prototype.slice;

/**
 * @param {function} func The original function.
 * @param {...*} args Bound argument values.
 * @returns {function} The partially applied function
 */
function partial(func /* args */) {
    var args = slice.call(arguments, 1);
    return function() {
        return func.apply(this, args.concat(slice.call(arguments)));
    };
}

上面的代码触发了一个警告，说“JSDoc 中描述的参数 args 没有出现在函数签名中”。在 WebStorm 内部，他们有一些 JS 文件类似地注释以支持自动完成诸如 Function.prototype.call 之类的东西，但这些文件仅用作库。因此，他们可以在他们的签名中包含任何内容，因此他们只需为此在末尾添加一个额外的参数(在本例中为“args”)。不过，在常规代码中，这并不是一个真正的选择。

WebStorm 是否实际接受了这种语法的任何形式而没有提示，或者这只是一个错误/缺失的功能？

Answer 1

如果我在 Michael Bollin 的书中没记错的话，你仍然需要将第二个参数添加到函数签名中，即使你将通过 JavaScript 的特殊数组类参数对象(每个函数都可用)访问额外的参数，而不是您在签名中指定的。