Rest parameters

rest parameter 構文は、配列としての引数の不特定多数を表現することができます。

構文

function(a, b, ...theArgs) {
  // ...
}

説明

関数の最後の名前付き引数が...で前置されていた場合、0からtheArgs.lengthまでの要素が関数に渡される実引数によって供給されている配列になります。

上記の例では、theArgsは、(最初の引数はaにマッピングされ、2番目の引数はbにマッピングされるので)関数の3番目の引数とすべての連続した引数を集めます。

rest parametersとargumentsオブジェクトの間の違い

rest parametersとargumentsオブジェクトの間に三つの主な違いがあります。:

• rest parametersは別々の名前が与えられていないだけです。ところが一方、 argumentsオブジェクトは、関数に渡されるすべての引数を含みます。;
• argumentsオブジェクトは実配列ではありません。ところが一方、rest parametersは、Arrayインスタンスです。これは、sort、map、forEach、popのようなメソッドが直接に適用することができることを意味します。
• arguments オブジェクトは、(calleeプロパティのように)自身への追加機能の特定を持っています。

引数から配列まで

rest parametersは引数によって誘導された定型的なコードを減らすために導入されました。

// Before rest parameters, the following could be found:
function f(a, b){
  var args = Array.prototype.slice.call(arguments, f.length);

  // ...
}

// to be equivalent of

function(a, b, ...args) {
  
}

例

theArgsは配列であるので、lengthプロパティを使用することによって要素の数を取得できます。:

function fun1(...theArgs) {
  console.log(theArgs.length);
}

fun1();  // 0
fun1(5); // 1
fun1(5, 6, 7); // 3

次の例では、二番目の引数から最後の引数までを集めるためにrest parametersを使用します。それから、最初の引数によってそれらを乗算します。:

function multiply(multiplier, ...theArgs) {
  return theArgs.map(function (element) {
    return multiplier * element;
  });
}

var arr = multiply(2, 1, 2, 3); 
console.log(arr); // [2, 4, 6]

次の例では、rest parameters上でArrayメソッドを使用できることを示します。しかし、argumentsオブジェクト上ではできません。:

function sortRestArgs(...theArgs) {
  var sortedArgs = theArgs.sort();
  return sortedArgs;
}

console.log(sortRestArgs(5,3,7,1)); // shows 1,3,5,7

function sortArguments() {
  var sortedArgs = arguments.sort(); 
  return sortedArgs; // this will never happen
}

// throws a TypeError: arguments.sort is not a function
console.log(sortArguments(5,3,7,1));

argumentsオブジェクト上でArrayメソッドを使用するために、最初に実配列に変換する必要があります。

仕様

ブラウザ実装状況

関連情報

• Arguments object
• Array
• Functions
• Spread Operator
• Original proposal at ecmascript.org
• JavaScript arguments object and beyond