Что такое «Остаточные параметры»

Функции часто должны принимать произвольное число значений: сложить любое количество цен, записать в лог сколько угодно сообщений, добавить в класс несколько модификаторов. До ES2015 для этого читали псевдомассив arguments, у которого нет методов map, filter и reduce. Остаточные параметры (rest parameters) дают обычный массив и прямо в объявлении показывают, что функция принимает «хвост» аргументов.

Пример

function sum(...prices) {
  return prices.reduce((acc, p) => acc + p, 0);
}
sum(100, 250, 49); // 399

function log(level, ...messages) {
  console[level](new Date().toISOString(), ...messages);
}
log('warn', 'Корзина пуста', { userId: 7 });

const { id, ...fields } = product; // остаток свойств объекта

В функции log первый аргумент попадает в level, а все остальные — в массив messages. Если лишних аргументов нет, массив будет пустым, а не undefined.

Правила синтаксиса

  • Rest-параметр может быть только один и только последним: function f(...a, b) — синтаксическая ошибка.
  • Свойство length функции его не учитывает: у log оно равно 1.
  • У стрелочных функций нет собственного arguments, поэтому для переменного числа аргументов в них подходят только остаточные параметры.
  • Тот же приём работает при деструктуризации: последняя строка примера забирает id, а остальные свойства объекта складывает в fields.

Rest или spread

Троеточие в JavaScript означает две противоположные операции, и различить их помогает место. В списке параметров функции или слева от знака = оно собирает значения в массив или объект — это rest. В вызове функции, в литерале массива или объекта оно раскладывает коллекцию на отдельные элементы — это spread-синтаксис. В примере с log встречаются оба: ...messages в объявлении собирает аргументы, а ...messages в вызове console[level] раскладывает их обратно.

В PHP есть аналог — вариативные функции с ...$args, которые тоже собирают аргументы в массив. Это пригодится, если вы пишете и фронтенд, и серверную часть сайта.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Frontend» ↗