Our volunteers haven't translated this article into عربي yet. Join us and help get the job done!
You can also read the article in English (US).

The rest parameter syntax allows us to represent an indefinite number of arguments as an array.


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


If the last named parameter of a function is prefixed with ..., it becomes an array whose elements from 0 (inclusive) to theArgs.length (exclusive) are supplied by the actual arguments passed to the function.

In the above example, theArgs would collect the third argument of the function (because the first one is mapped to a, and the second to b) and all the consecutive arguments.

Difference between rest parameters and the arguments object

There are three main differences between rest parameters and the arguments object:

  • rest parameters are only the ones that haven't been given a separate name (i.e. formally defined in function expression), while the arguments object contains all arguments passed to the function;
  • the arguments object is not a real array, while rest parameters are Array instances, meaning methods like sort, map, forEach or pop can be applied on it directly;
  • the arguments object has additional functionality specific to itself (like the callee property).

From arguments to an array

Rest parameters have been introduced to reduce the boilerplate code that was induced by the arguments

// 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 f(a, b, ...args) {

Destructuring rest parameters

Rest parameters can be destructured, that means that their data can be unpacked into distinct variables. See Destructuring assignment.

function f(...[a, b, c]) {
  return a + b + c;

f(1)          // NaN (b and c are undefined)
f(1, 2, 3)    // 6
f(1, 2, 3, 4) // 6 (the fourth parameter is not destructured)


Since theArgs is an array, a count of its elements is given by the length property:

function fun1(...theArgs) {

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

In the next example, a rest parameter is used to collect all arguments after the first one in an array. Each one of them is then multiplied by the first parameter and the array is returned:

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]

The following example shows that Array methods can be used on rest parameters, but not on the arguments object:

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

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

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

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

In order to use Array methods on the arguments object, it must be converted to a real array first.

function sortArguments() {
  var args = Array.from(arguments);
  var sortedArgs = args.sort();
  return sortedArgs;
console.log(sortArguments(5, 3, 7, 1)); // 1, 3, 5, 7


Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Function Definitions' in that specification.
Standard Initial definition
ECMAScript Latest Draft (ECMA-262)
The definition of 'Function Definitions' in that specification.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support471215 No3410
Destructuring rest parameters49 No52 No36 ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support4747121534105.0
Destructuring rest parameters4949 No5236 ?5.0

1. From version 4 until version 6 (exclusive): this feature is behind the --harmony-rest-parameters runtime flag.

See also

Document Tags and Contributors

آخر مَن حدّثها: mcrosby114,