Что такое «Остаточные параметры»
Функции часто должны принимать произвольное число значений: сложить любое количество цен, записать в лог сколько угодно сообщений, добавить в класс несколько модификаторов. До 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

