`arguments` 是一个对应于传递给函数的参数的类数组对象。

## 语法

    arguments

## 描述

`arguments`对象是所有（非箭头）函数中都可用的局部变量。你可以使用`arguments`对象在函数中引用函数的参数。此对象包含传递给函数的每个参数，第一个参数在索引0处。例如，如果一个函数传递了三个参数，你可以以如下方式引用他们：

    arguments[0]
    arguments[1]
    arguments[2]

参数也可以被设置：

    arguments[1] = 'new value';

`arguments`对象不是一个 `Array` 。它类似于`Array`，但除了length属性和索引元素之外没有任何`Array`属性。例如，它没有 pop 方法。但是它可以被转换为一个真正的`Array`：

    var args = Array.prototype.slice.call(arguments);
    var args = [].slice.call(arguments);

    // ES2015
    const args = Array.from(arguments);
    const args = [...arguments];

对参数使用slice会阻止某些JavaScript引擎中的优化 (比如 V8 - 更多信息)。如果你关心性能，尝试通过遍历arguments对象来构造一个新的数组。另一种方法是使用被忽视的`Array`构造函数作为一个函数：

    var args = (arguments.length === 1 ? [arguments[0]] : Array.apply(null, arguments));

如果调用的参数多于正式声明接受的参数，则可以使用`arguments`对象。这种技术对于可以传递可变数量的参数的函数很有用。使用 `arguments.length`来确定传递给函数参数的个数，然后使用`arguments`对象来处理每个参数。要确定函数签名中（输入）参数的数量，请使用`Function.length`属性。

### 对参数使用 `typeof`

typeof参数返回 'object'。

    console.log(typeof arguments);    // 'undefined'
    // arguments 对象只能在函数内使用
    function test(a){
        console.log(a,Object.prototype.toString.call(arguments));
        console.log(arguments[0],arguments[1]);
        console.log(typeof arguments[0]);
    }
    test(1);
    /*
    1 "[object Arguments]"
    1 undefined
    number
    */

可以使用索引确定单个参数的类型。

    console.log(typeof arguments[0]); //this will return the typeof individual arguments.

### 对参数使用扩展语法

您还可以使用`Array.from()`方法或扩展运算符将参数转换为真实数组：

    var args = Array.from(arguments);
    var args = [...arguments];

## 属性

`arguments.callee`
  指向当前执行的函数。
`arguments.caller`
  指向调用当前函数的函数。
`arguments.length`
  指向传递给当前函数的参数数量。
`arguments[@@iterator]`
  返回一个新的Array迭代器对象，该对象包含参数中每个索引的值。
注意:现在在严格模式下，`arguments`对象已与过往不同。`arguments[@@iterator]`不再与函数的实际形参之间共享，同时caller属性也被移除。

## 例子

### 遍历参数求和

    function add() {
        var sum =0,
            len = arguments.length;
        for(var i=0; i<len; i++){
            sum += arguments[i];
        }
        return sum;
    }
    add()                           // 0
    add(1)                          // 1
    add(1,2,3,4);                   // 10

### 定义连接字符串的函数

这个例子定义了一个函数来连接字符串。这个函数唯一正式声明了的参数是一个字符串，该参数指定一个字符作为衔接点来连接字符串。该函数定义如下：

    function myConcat(separator) {
      var args = Array.prototype.slice.call(arguments, 1);
      return args.join(separator);
    }

你可以传递任意数量的参数到该函数，并使用每个参数作为列表中的项创建列表。

    // returns "red, orange, blue"
    myConcat(", ", "red", "orange", "blue");

    // returns "elephant; giraffe; lion; cheetah"
    myConcat("; ", "elephant", "giraffe", "lion", "cheetah");

    // returns "sage. basil. oregano. pepper. parsley"
    myConcat(". ", "sage", "basil", "oregano", "pepper", "parsley");

### 定义创建HTML列表的方法

这个例子定义了一个函数通过一个字符串来创建HTML列表。这个函数唯一正式声明了的参数是一个字符。当该参数为 "`u`" 时，创建一个无序列表 (项目列表)；当该参数为 "`o`" 时，则创建一个有序列表 (编号列表)。该函数定义如下：

    function list(type) {
      var result = "<" + type + "l><li>";
      var args = Array.prototype.slice.call(arguments, 1);
      result += args.join("</li><li>");
      result += "</li></" + type + "l>"; // end list

      return result;
    }

你可以传递任意数量的参数到该函数，并将每个参数作为一个项添加到指定类型的列表中。例如：

    var listHTML = list("u", "One", "Two", "Three");

    /* listHTML is:

    "<ul><li>One</li><li>Two</li><li>Three</li></ul>"

    */

### 剩余参数、默认参数和解构赋值参数

`arguments`对象可以与剩余参数、默认参数和解构赋值参数结合使用。

    function foo(...args) {
      return args;
    }
    foo(1, 2, 3);  // [1,2,3]

在严格模式下，剩余参数、默认参数和解构赋值参数的存在不会改变 `arguments`对象的行为，但是在非严格模式下就有所不同了。

当非严格模式中的函数没有包含剩余参数、默认参数和解构赋值，那么`arguments`对象中的值会跟踪参数的值（反之亦然）。看下面的代码：

    function func(a) {
      arguments[0] = 99;   // 更新了arguments[0] 同样更新了a
      console.log(a);
    }
    func(10); // 99

并且

    function func(a) {
      a = 99;              // 更新了a 同样更新了arguments[0]
      console.log(arguments[0]);
    }
    func(10); // 99

当非严格模式中的函数有包含剩余参数、默认参数和解构赋值，那么`arguments`对象中的值不会跟踪参数的值（反之亦然）。相反, `arguments`反映了调用时提供的参数：

    function func(a = 55) {
      arguments[0] = 99; // updating arguments[0] does not also update a
      console.log(a);
    }
    func(10); // 10

并且

    function func(a = 55) {
      a = 99; // updating a does not also update arguments[0]
      console.log(arguments[0]);
    }
    func(10); // 10

并且

    function func(a = 55) {
      console.log(arguments[0]);
    }
    func(); // undefined

## 规范

Specification | Status | Comment
--- | --- | ---
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.1
ECMAScript 5.1 (ECMA-262) Arguments Object | Standard |
ECMAScript 2015 (6th Edition, ECMA-262) Arguments Exotic Objects | Standard |
ECMAScript Latest Draft (ECMA-262) Arguments Exotic Objects | Draft |

## 浏览器兼容

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

| Desktop | Mobile | Server
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | Safari on iOS | Samsung Internet | Node.js
`arguments` | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
`callee` | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 1 | IE Full support 6 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
`caller` Deprecated Non-standard | Chrome No support No | Edge No support No | Firefox No support No | IE No support ? — 9 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Edge Mobile No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No | nodejs No support No
`length` | Chrome Full support Yes | Edge Full support Yes | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Edge Mobile Full support Yes | Firefox Android Full support 4 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes | nodejs Full support Yes
`@@iterator` | Chrome Full support 52 | Edge ? | Firefox Full support 46 | IE No support No | Opera Full support Yes | Safari Full support 9 | WebView Android Full support 52 | Chrome Android Full support 52 | Edge Mobile ? | Firefox Android Full support 46 | Opera Android Full support Yes | Safari iOS Full support 9 | Samsung Internet Android Full support 6.0 | nodejs Full support Yes

### Legend

Full support
  Full support
No support
  No support
Compatibility unknown
  Compatibility unknown
Non-standard. Expect poor cross-browser support.
  Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
  Deprecated. Not for use in new websites.

## 相关链接

- `Function`