arguments.length

値

非負の整数です。

解説

arguments.length プロパティは、実際に関数に渡された引数の数を提供します。これは、定義された仮引数の数以上にも以下にもなることがあります（Function.prototype.length を参照してください）。

function func1(a, b, c) {
  console.log(arguments.length);
}

func1.length は 3 を返します。これは func1 が 3 つの形式引数を宣言しているためです。しかし、func1(1, 2, 3, 4, 5) は 5 をログ出力します。これは func1 が5つの引数をつけて呼び出されたためです。同様に、func1(1) は 1 をログ出力します。これは func1 が 1 つの引数をつけて呼び出されたためです。

例

arguments.length の使用

この例では、2 つ以上の数を加算する関数を定義しています。

function adder(base /*, num1, …, numN */) {
  base = Number(base);
  for (let i = 1; i < arguments.length; i++) {
    base += Number(arguments[i]);
  }
  return base;
}

仕様書

ブラウザーの互換性

関連情報

• 関数ガイド
• 関数
• arguments
• Function: length