可变参数的 Google Closure Compiler @param 注解

Question

我有一个可以接受可变数量参数的函数。

根据Google Closure Compiler wiki，这是使用@param注解的方式。

/**
 * Takes 2 or more strings and do something cool with them.
 * @param {...string} var_args
 * @return {string} the processed result
 */
function doSomethingCool() {
    var len = arguments.length;
    if (len < 2) {
        throw Error('Need at least 2 arguments');
    }

    ...
}

问题

当我尝试编译它时，我看到了这个警告：JSC_INEXISTENT_PARAM: parameter var_args does not appear in doSomethingCool's parameter list at line 6 character 1

所以我尝试了@param {string} arguments，但同样的错误。

我还尝试了@param {string} 没有变量名。我得到了：JSC_TYPE_PARSE_ERROR: Bad type annotation. expecting a variable name in a @param tag.

问题

我做错了什么，如何为 Closure Compiler 注释可变参数？

Answer 1

您的var_args 需要实际出现在错误告诉您的参数列表中。

/**
 * Takes 2 or more strings and do something cool with them.
 * @param {...string} var_args
 * @return {string} the processed result
 */
function doSomethingCool(var_args) {}

Closure-compiler 将识别出它从未被引用并在编译期间将其删除。

如果将它列在那里让您感到困扰，您可以使用 @type 注释代替：

/**
 * Takes 2 or more strings and do something cool with them.
 * @type {function(...string):string}
 */
function doSomethingCool() {}

如果您真的想要正确的类型检查，请对函数进行注释，使其接受 2 个或更多字符串：

/**
 * Takes 2 or more strings and do something cool with them.
 * @type {function(string, string, ...string):string}
 */
function doSomethingCool() {}