arguments 对象
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
arguments 是一个类数组对象，可在函数内部访问，其中包含传递给该函数的参数值。
尝试一下
function func1(a, b, c) {
console.log(arguments[0]);
// 期望输出：1
console.log(arguments[1]);
// 期望输出：2
console.log(arguments[2]);
// 期望输出：3
}
func1(1, 2, 3);
描述
备注：现代代码优先推荐使用剩余参数语法。
arguments 对象是所有非箭头函数中都可用的局部变量。你可以使用 arguments 对象在函数中引用函数的参数。此对象包含传递给函数的每个参数，第一个参数在索引 0 处。
例如，如果一个函数传递了三个参数，你可以使用如下方式引用他们：
arguments[0]; // 第一个参数
arguments[1]; // 第二个参数
arguments[2]; // 第三个参数
arguments 对象适用于接收的参数数量超过其形式声明数量的函数，即可变参数函数，例如 Math.min()。此示例函数可接收任意数量的字符串参数，并返回其中最长的字符串：
function longestString() {
let longest = "";
if (arguments.length === 0) {
throw new TypeError("至少需要传递一个字符串");
}
for (const arg of arguments) {
if (arg.length > longest.length) {
longest = arg;
}
}
return longest;
}
你可以使用 arguments.length 来统计函数被调用时接收的参数数量。若需统计函数声明时接受的参数数量，请检查该函数的 length 属性。
通过索引赋值
每个参数索引也可以被设置或重新赋值：
arguments[1] = "新值";
仅包含简单参数（即不含剩余参数、默认参数或解构参数）的非严格函数会将参数的新值与 arguments 对象同步，反之亦然：
function func(a) {
arguments[0] = 99; // 更新 arguments[0] 也会更新 a
console.log(a);
}
func(10); // 99
function func2(a) {
a = 99; // 更新 a 也会更新 arguments[0]
console.log(arguments[0]);
}
func2(10); // 99
非严格函数若传递了剩余参数、默认值或解构参数，不会将函数体中赋予参数的新值同步到 arguments 对象。相反，在具有复杂参数的非严格函数中，arguments 对象始终反映函数调用时传递的值。
function funcWithDefault(a = 55) {
arguments[0] = 99; // 更新 arguments[0] 不会更新 a
console.log(a);
}
funcWithDefault(10); // 10
function funcWithDefault2(a = 55) {
a = 99; // 更新 a 不会更新 arguments[0]
console.log(arguments[0]);
}
funcWithDefault2(10); // 10
// 未跟踪的默认参数
function funcWithDefault3(a = 55) {
console.log(arguments[0]);
console.log(arguments.length);
}
funcWithDefault3(); // undefined; 0
这是所有严格模式函数的共同行为，无论传递的参数类型如何。也就是说，在函数体内为参数赋新值永远不会影响 arguments 对象，同样地，为 arguments 索引赋新值也不会改变参数的值——即使函数仅包含简单参数也是如此。
备注：在接受剩余参数、默认参数或解构参数的函数定义主体中，不能使用 "use strict"; 指令。这样做将抛出语法错误。
arguments 是类数组对象
arguments 是一个类数组对象，这意味着它具有 length 属性，且属性索引从零开始，但它不具备 Array 的内置方法，例如 forEach() 或 map()。不过，可通过以下方式将其转换为真正的 Array：使用 slice()、Array.from() 或展开语法。
const args = Array.prototype.slice.call(arguments);
// 或
const args = Array.from(arguments);
// 或
const args = [...arguments];
对于常见用例，将其作为类数组对象使用已足够，因为它既可迭代，又具备 length 属性及数字索引。例如，Function.prototype.apply() 方法接受类数组对象。
function midpoint() {
return (
(Math.min.apply(null, arguments) + Math.max.apply(null, arguments)) / 2
);
}
console.log(midpoint(3, 1, 4, 1, 5)); // 3
属性
arguments.callee已弃用-
指向参数所属的当前执行的函数。在严格模式中禁用。
arguments.length-
传递给函数的参数数量。
arguments[Symbol.iterator]-
返回一个新的数组迭代器对象，该对象包含
arguments中每个索引的值。
示例
定义连接字符串的函数
这个例子定义了一个函数来连接字符串。这个函数唯一的形式参数是一个字符串，其中包含用于分隔待连接项的分隔符。该函数定义如下：
function myConcat(separator) {
const args = Array.prototype.slice.call(arguments, 1);
return args.join(separator);
}
你可以传递任意数量的参数到该函数，并使用每个参数作为列表中的项创建列表。
myConcat(", ", "red", "orange", "blue");
// "red, orange, blue"
myConcat("; ", "elephant", "giraffe", "lion", "cheetah");
// "elephant; giraffe; lion; cheetah"
myConcat(". ", "sage", "basil", "oregano", "pepper", "parsley");
// "sage. basil. oregano. pepper. parsley"
定义创建 HTML 列表的函数
这个例子定义了一个函数通过一个字符串来创建 HTML 列表。这个函数唯一的形式参数是一个字符。当该参数为 "u" 时，创建一个无序列表（项目列表）；当该参数为 "o" 时，则创建一个有序列表（编号列表）。该函数定义如下：
function list(type) {
let html = `<${type}l><li>`;
const args = Array.prototype.slice.call(arguments, 1);
html += args.join("</li><li>");
html += `</li></${type}l>`; // 列表结束
return html;
}
你可以传递任意数量的参数到该函数，并将每个参数作为一个项添加到指定类型的列表中。例如：
list("u", "一", "二", "三");
// "<ul><li>一</li><li>二</li><li>三</li></ul>"
typeof 与 arguments
typeof 运算符对 arguments 返回 object：
console.log(typeof arguments); // 'object'
通过索引 arguments 可确定各个参数的类型：
console.log(typeof arguments[0]); // 返回第一个参数的类型
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-arguments-exotic-objects |