假设您有以下内容：
var someFunc = function() {
// do something here with arguments
}
你如何正确地证明这个函数可以在 JSDoc 中接受任意数量的参数？这是我最好的猜测，但我不确定它是否正确。
/**
* @param {Mixed} [...] Unlimited amount of optional parameters
*/
var someFunc = function() {
// do something here with arguments
}
【问题讨论】：
标签： javascript jsdoc
JSDoc specs 和 Google's Closure Compiler 这样做：
@param {...number} var_args
其中“数字”是预期的参数类型。
那么，它的完整用法如下所示：
/**
* @param {...*} var_args
*/
function lookMaImVariadic(var_args) {
// Utilize the `arguments` object here, not `var_args`.
}
请注意关于使用arguments（或arguments 的一些偏移量）来访问您的其他参数的评论。 var_args 它只是用来向您的 IDE 发出该参数确实存在的信号。
Rest parameters in ES6 可以将实际参数进一步包含提供的值（因此不再需要使用arguments）：
/**
* @param {...*} var_args
*/
function lookMaImES6Variadic(...var_args) {
// Utilize the `var_args` array here, not `arguments`.
}
【讨论】：
var_args 的实际变量或任何您想作为唯一参数调用的变量。可悲的黑客。
/** @param {...Function} tasks The tasks. */ function waterfallTasks(...tasks) { 其余参数始终在参数中具有功能性存在。
如何做到这一点是 JSDoc 文档中的 now described，它使用省略号，就像 Closure 文档一样。
@param {...<type>} <argName> <Argument description>
您需要在省略号之后提供一个类型，但您可以使用* 来描述接受任何内容，或使用| 来分隔多个可接受的类型。在生成的文档中，JSDoc 将把这个参数描述为 repeatable，就像它把可选参数描述为 optional 一样。
在我的测试中，实际的 javascript 函数定义中不需要有参数，因此您的实际代码可以只有空括号，即function whatever() { ... }。
单一类型：
@param {...number} terms Terms to multiply together
任何类型（在下面的示例中，方括号表示items 将被标记为可选和可重复）：
@param {...*} [items] - zero or more items to log.
多个类型需要在类型列表周围加上括号，省略号在左括号之前：
@param {...(Person|string)} attendees - Meeting attendees, listed as either
String names or {@link Person} objects
【讨论】：
@param {{...(key: value)}} [config] - specific configs for this transfer 但想知道这是否正确？
没有任何官方方法，但一种可能的解决方案是：
/** * @param [...] Zero or more child nodes. If zero then ... otherwise .... */方括号表示一个可选参数，而 ... （对我而言）表示“某个任意数字”。
另一种可能是这个……
/** * @param [arguments] The child nodes. */无论哪种方式都应该传达您的意思。
虽然（2007 年）有点过时，但我不知道有什么更新的。
如果您需要将参数类型记录为“混合”，请使用{*}，如@param {*} [arguments]。
【讨论】：
@param [arguments]（或 @param {*} [arguments]）以及 Google Closure 编译器建立的语法（在另一个答案中提到） .不支持@param [...]。
我为此纠结了很长时间。以下是使用 Google Closure Compiler 的方法：
/**
* @param {...*} var_args
*/
function my_function(var_args) {
// code that accesses the magic 'arguments' variable...
}
关键是给你的函数一个var_args 参数（或者你在@param 语句中调用的任何参数），即使函数实际上并没有使用那个参数。
【讨论】：