arguments.length

Свойство данных arguments.length содержит количество аргументов, переданных функции.

Значение

Неотрицательное целое число.

Описание

Свойство arguments.length предоставляет количество аргументов, фактически переданных функции. Это может быть больше или меньше количества определенных параметров (см. Function.prototype.length). Например, для следующей функции:

function func1(a, b, c) {
  console.log(arguments.length);
}

func1.length возвращает 3, потому что func1 объявляет три формальных параметра. Однако func1(1, 2, 3, 4, 5) выводит в консоль 5, потому что func1 была вызвана с пятью аргументами. Аналогично, func1(1) выводит в консоль 1, потому что func1 была вызвана с одним аргументом.

Примеры

Использование arguments.length

В этом примере мы определяем функцию, которая может складывать два или более числа.

function adder(base /*, num1, …, numN */) {
  base = Number(base);
  for (let i = 1; i < arguments.length; i++) {
    base += Number(arguments[i]);
  }
  return base;
}

Спецификации

Совместимость с браузерами

См. также

• Руководство по функциям
• Функции
• arguments
• Function: length