DEV Community

Cover image for Understanding Rest Parameter Syntax
Laurie
Laurie

Posted on • Originally published at tenmilesquare.com

Understanding Rest Parameter Syntax

Welcome to Rest parameter syntax. It's like the spread operator!

...except not.

I want to say upfront that I'm not justifying the repeated use of the ... symbol in the JavaScript language. But hopefully, this post will help you understand how spread and rest are different yet similar.

The use case for rest

Let's say that you want to pass in an unknown number of arguments to a function. That's when you want to use the rest parameter!

function testRest(arg1, arg2, ...otherArgs) {
   console.log(arg1) // 1
   console.log(arg2) // 2
   console.log(otherArgs) // [3, 4, 5]

}

testRest(1, 2, 3, 4, 5)
Enter fullscreen mode Exit fullscreen mode

In this example arg1 and arg2 are passed through as expected, then all of the additional arguments are added to the otherArgs array.

One of the benefits is that otherArgs is truly an array. That means all of your array functions are available.

You can look at the number of arguments inside of it.

function testRest(arg1, arg2, ...otherArgs) {
   const numOfArgs = otherArgs.length() // 3

}

testRest(1, 2, 3, 4, 5)
Enter fullscreen mode Exit fullscreen mode

You can also manipulate it using array prototype functions. map, filter, reduce, flat, etc.

Single Extra Argument

One thing to keep in mind is that otherArgs will always create an array. That means that a single argument will be wrapped in an array.

function testRest(arg1, arg2, ...otherArgs) {
   console.log(arg1) // 1
   console.log(arg2) // 2
   console.log(otherArgs) // [3]

}

testRest(1, 2, 3)
Enter fullscreen mode Exit fullscreen mode

Additionally, not including any additional arguments will result in an empty array.

function testRest(arg1, arg2, ...otherArgs) {
   console.log(arg1) // 1
   console.log(arg2) // 2
   console.log(otherArgs) // []

}

testRest(1, 2)
Enter fullscreen mode Exit fullscreen mode

Remember destructuring?

If you need a quick refresh on destructuring assignment check out this post.

As it turns out, you can use destructuring and the rest parameter together.

function testRest(...[first, second, third]) {
   console.log(first) // 1
   console.log(second) // 2
   console.log(third) // 3

}

testRest(1, 2, 3)
Enter fullscreen mode Exit fullscreen mode

Keep in mind that destructuring expects the arguments to be there. If you break that contract, you should know what to expect.

If you don't include a destructured expected argument, it will result in an undefined reference.

function testRest(...[first, second, third]) {
   console.log(first) // 1
   console.log(second) // 2
   console.log(third) // undefined

}

testRest(1, 2)
Enter fullscreen mode Exit fullscreen mode

If you include an argument beyond what you've destructured, that argument will be dropped.

function testRest(...[first, second, third]) {
   console.log(first) // 1
   console.log(second) // 2
   console.log(third) // 3
   // 4 is not destructured

}

testRest(1, 2, 3, 4)
Enter fullscreen mode Exit fullscreen mode

Conclusion

And there you have it! As you can see in the examples above the main difference between rest and spread is location.

Spread syntax can appear inside a function or when calling the function. Rest parameter syntax is limited to the function signature itself. Keep that in mind if you're trying to determine which is being used.

Hope this helped you understand the concepts better.

As always, if you're interested in concepts like this one, check out some of these posts:

Top comments (11)

Collapse
 
kenbellows profile image
Ken Bellows • Edited

Personally I like the dual use of the ... for rest and spread. They're sort of symmetric operations, and it strikes me as rather intuitive and elegant to use the same symbol, and one you understand the contexts in which they're used (which I think you've explained very well), it feels natural. But that's just me, I'd be interested to hear a counter perspective!

Collapse
 
laurieontech profile image
Laurie

I think once you know them that's absolutely true. But I wouldn't call it intuitive just based on readability. I'm also of the camp that ... was a poor choice. I can make sense of it, but it doesn't invoke much. Perhaps a keyword may have been better.

Collapse
 
georgecoldham profile image
George • Edited

Out of curiosity, why are you choosing to use

function(...[arg1, arg2, arg3]) { //... }

over

function({ arg1, arg2, arg3 }) { //... }

?

Is there any technical differences or is this just syntactical preference?

Collapse
 
laurieontech profile image
Laurie

The first example is using the rest parameter, which is what the article is meant to explain.

The second example would not apply for the example above since it's only passing integers. It would work if the example looked like this though.

function testRest({ first }) {
  console.log(first);
}
testRest({ first: 1 });

However, the "infinite" number of arguments use case is not handled unless the arguments in question are already in an object and their key names are known. It's a very different piece of syntax.

Collapse
 
ulitroyo profile image
Uli Troyo

Good piece, thanks! I've known about the spread operator for a little while, but it hasn't yet made its way into my reach-for arsenal. I don't seem to remember to use it at the opportune times. Do you find there's a particular use case where it clicked for you?

Collapse
 
laurieontech profile image
Laurie

Probably my most common use case is merging an array or object into something I'm defining. Like so:

const arr = [1,2,3,4]

const numbers = [...arr, 6,7,10]
Collapse
 
ulitroyo profile image
Uli Troyo

You said that it always creates an array, right? Would the result be [[1,2,3,4], 6,7,10]?

...Oh, nevermind, just tried it in the console! It flattens it; that makes a lot of sense!

Thread Thread
 
laurieontech profile image
Laurie

Yup! Check out this post if you want that example specifically. It's essentially grabbing each element in the array and dropping it into a new array structure.

Collapse
 
jacobmgevans profile image
Jacob Evans

Interesting! I have some ideas about use cases now. Definitely cleared up a couple of things.

Collapse
 
laurieontech profile image
Laurie

Glad to hear it!

Collapse
 
laurieontech profile image
Laurie

Yup, certainly good examples. I opted for function signature since that’s a pretty common use case. But “the rest of” is a great way to think about it.