Register to get access to free programming courses with interactive exercises

Spread syntax (unpacking arguments) JS: Functions

The spread statement in function calls is syntactically identical to the rest statement in definitions, but does the opposite. Let's take the sum() function as an example:

const sum = (...numbers) => {
  let result = 0;
  for (let num of numbers) {
    result += num;
  return result;

Let's call sum() by applying the spread statement to an array of arguments:

const numbers = [1, 7, 4];
sum(...numbers); // 12

The spread statement decomposes the array into arguments. The number of arguments received by the spread statement is equal to the number of array elements. In essence, the code above is converted into a call:

sum(numbers[0], numbers[1], numbers[2]);
// sum(1, 7, 4);

As with function definitions, the spread operator can be used in conjunction with positional arguments:

const numbers = [1, 7, 4];
sum(8, ...numbers); // 20

sum(8, 10, ...numbers);     // 30
sum(8, 10, 70, ...numbers); // 100

Unlike the rest-operator in the definition of functions, the spread-operator does not have to be last, it can be in any position:

const numbers = [1, 7, 4];

sum(8, 10, ...numbers); // 30
sum(8, ...numbers, 10); // 30
sum(...numbers, 8, 10); // 30

Moreover, there can be any number of spread operators and in any order:

const numbers1 = [1, 7, 4];
const numbers2 = [5, 5];

// sum(1, 7, 4, 5, 5);
sum(...numbers1, ...numbers2); // 22

// sum(5, 5, 1, 7, 4);
sum(...numbers2, ...numbers1); // 22

// sum(8, 1, 7, 4, 10, 5, 5);
sum(8, ...numbers1, 10, ...numbers2); // 40

Hexlet Experts

Are there any more questions? Ask them in the Discussion section.

The Hexlet support team or other students will answer you.

About Hexlet learning process

For full access to the course you need a professional subscription.

A professional subscription will give you full access to all Hexlet courses, projects and lifetime access to the theory of lessons learned. You can cancel your subscription at any time.

Get access
hours of theory

Sign up

Programming courses for beginners and experienced developers. Start training for free

  • 130 courses, 2000+ hours of theory
  • 1000 practical tasks in a browser
  • 360 000 students
By sending this form, you agree to our Personal Policy and Service Conditions

Our graduates work in companies:

<span class="translation_missing" title="translation missing:">Bookmate</span>
<span class="translation_missing" title="translation missing:">Healthsamurai</span>
<span class="translation_missing" title="translation missing:">Dualboot</span>
<span class="translation_missing" title="translation missing:">Abbyy</span>
Suggested learning programs
Development of front-end components for web applications
10 months
from scratch
Start at any time

Use Hexlet to the fullest extent!

  • Ask questions about the lesson
  • Test your knowledge in quizzes
  • Practice in your browser
  • Track your progress

Sign up or sign in

By sending this form, you agree to our Personal Policy and Service Conditions
Toto Image

Ask questions if you want to discuss a theory or an exercise. Hexlet Support Team and experienced community members can help find answers and solve a problem.