Функция: length

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

Попробуйте

function func1() {}

function func2(a, b) {}

console.log(func1.length);
// Expected output: 0

console.log(func2.length);
// Expected output: 2

Значение

Число.

Описание

Свойство length объекта Function указывает, сколько аргументов ожидает функция, то есть количество формальных параметров:

• Учитываются только параметры перед первым параметром с значением по умолчанию.
• Шаблон деструктуризации считается одним параметром.
• Остаточные параметры исключены.

В отличие от этого, arguments.length является локальным для функции и предоставляет количество аргументов, фактически переданных функции.

Конструктор Function сам по себе является объектом Function. Его свойство данных length имеет значение 1.

По историческим причинам Function.prototype сам является вызываемым. Свойство length объекта Function.prototype имеет значение 0.

Примеры

Использование длины функции

console.log(Function.length); // 1

console.log((() => {}).length); // 0
console.log(((a) => {}).length); // 1
console.log(((a, b) => {}).length); // 2 etc.

console.log(((...args) => {}).length);
// 0, rest parameter is not counted

console.log(((a, b = 1, c) => {}).length);
// 1, only parameters before the first one with
// a default value are counted

console.log((({ a, b }, [c, d]) => {}).length);
// 2, destructuring patterns each count as
// a single parameter

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

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

См. также

• Function