剩余参数用...args语法显式收集函数末尾的不定实参,必须为最后一个形参且唯一;它是真数组,支持map/filter等方法,优于arguments。

剩余参数用 ...args 语法收集不定数量的实参
JavaScript 剩余参数(Rest Parameters)不是“把所有没命名的参数塞进一个数组”,而是**显式声明一个参数名,用 ... 前缀告诉引擎:从当前位置起,所有剩下的实参都放进这个数组里**。它必须是函数最后一个形参,且只能有一个。
常见错误是把它和 arguments 对象混淆——arguments 是类数组、非真数组、没有 map/filter 方法;而剩余参数是标准 Array 实例,可直接调用数组方法。
-
function sum(...nums) { return nums.reduce((a, b) => a + b, 0); }—— 正确,nums是真数组 -
function sum(a, ...b, c) { }—— 报错:Rest parameter must be last formal parameter -
function sum(...a, ...b) { }—— 语法错误:不允许多个剩余参数
剩余参数 vs arguments:该选哪个?
优先用剩余参数。它更语义清晰、类型友好(TypeScript 可精确推导)、支持解构和数组方法。只有在需要访问被命名参数之外的“全部”实参(包括已被命名的),或需兼容极老环境(arguments。
注意:arguments 在箭头函数中不可用,而剩余参数天然支持箭头函数。
立即学习“Java免费学习笔记(深入)”;
- 需要类型提示或用
forEach处理参数?→ 用...args - 要读取第 0 个实参(哪怕它没被命名)?→
arguments[0]可行,但通常说明设计有问题 - 写 polyfill 或适配旧代码?→ 才需处理
arguments
剩余参数能和解构、默认值混用吗?
可以,而且很常用。剩余参数本身不参与默认值赋值,但前面的具名参数可以设默认值;解构也可直接作用于剩余参数变量。
function createPerson(name, age = 18, ...tags) {
const [role = 'user', level = 'basic'] = tags; // 解构剩余参数
return { name, age, role, level };
}
createPerson('Alice', 25, 'admin');
// → { name: 'Alice', age: 25, role: 'admin', level: 'basic' }
createPerson('Bob');
// → { name: 'Bob', age: 18, role: 'user', level: 'basic' }
注意:解构时如果 tags 是空数组,[role = 'user'] 仍会取默认值;但如果传了 undefined,解构会失败(除非用 ?? 或额外判断)。
剩余参数会影响函数的 length 属性
function.length 返回的是“不带默认值的、非剩余参数的形参数量”。也就是说,剩余参数不计入 length,带默认值的参数也不计入。
function f(a, b, ...rest) {}
console.log(f.length); // 2 —— 只算 a 和 b
function g(x = 1, ...y) {}
console.log(g.length); // 0 —— x 有默认值,rest 不计,所以为 0
这点在写高阶函数(比如柯里化、参数校验工具)时容易被忽略:不能靠 fn.length 准确判断“用户预期传几个必填参数”,尤其当函数用了默认值或剩余参数时。










