CKTIS / JavaScript
`Function.length` и арност на функциите
`fn.length` описва очакваната арност на функцията, а `arguments.length` брои аргументите, подадени при конкретно извикване.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.lengthАрността на функцията се отнася до броя на параметрите ѝ. В JavaScript fn.length е числово свойство, което описва очакваната арност, а не метод или условие за валидно извикване. За самия вграден конструктор Function.length е 1, а за извикваемия обект Function.prototype свойството length е 0.
При функция, дефинирана в изходния код, параметрите се броят отляво до първия параметър със стойност по подразбиране за целия параметър. Той и всички следващи параметри не се броят. Параметър за остатъчните аргументи като ...tail никога не се брои. Шаблонът за деструктуриране се брои като един параметър: вътрешната стойност по подразбиране в { x = 0 } не прекъсва броенето, но външното = {} в { x = 0 } = {} го прекъсва.
В обикновена функция arguments.length брои действително подадените при извикването аргументи, включително изрично подадено undefined. Стрелковите функции нямат собствено arguments; ако (...args) е целият списък с параметри, args.length брои всички техни аргументи. След именувани параметри масивът с остатъчните аргументи съдържа само останалите аргументи.
Ако функцията има непроменено собствено свойство length с крайна целочислена стойност, bind изважда броя на предварително обвързаните аргументи, без резултатът да пада под нула. thisArg не се брои. Първоначално length не може да се променя чрез присвояване и не е изброимо, но е конфигурируемо. Не го използвай за проверка на извикванията: JavaScript позволява различен брой аргументи, а резултатът зависи от функцията.
Примери
{
function inspect({ x = 0 }, y = 10, z, ...tail) {
return `${arguments.length}:${tail.length}`;
}
console.log(inspect.length);
console.log(inspect.bind(null, {}).length);
console.log(inspect({}));
console.log(inspect({}, undefined, 3, 4, 5));
console.log(Function.length);
console.log(Function.prototype.length);
}Резултат
1 0 1:0 5:2 1 0
`inspect.length` е `1`, защото се брои само `{ x = 0 }`. Предварителното обвързване на аргумента `{}` сваля стойността до `0`. В `1:0` и `5:2` първото число брои всички подадени аргументи, а второто — само елементите в `tail`. Изрично подаденото `undefined` се брои като аргумент, въпреки че задейства стойността по подразбиране за `y`.
Свързани уроци
- JavaScript · Урок 21 · Напреднало · Версия: 4
Източници
- ECMAScript® 2024 Language Specification — Static Semantics: ExpectedArgumentCount
- ECMAScript® 2024 Language Specification — Function Instances: length
- ECMAScript® 2024 Language Specification — Function.prototype.bind
- Function: length - JavaScript | MDN
- The arguments object - JavaScript | MDN
- Rest parameters - JavaScript | MDN