CKTIS / JavaScript
`Function.length` i arność funkcji
`fn.length` opisuje oczekiwaną arność funkcji, a `arguments.length` podaje liczbę argumentów przekazanych w konkretnym wywołaniu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.lengthArność funkcji dotyczy liczby jej parametrów. W JavaScript fn.length to właściwość liczbowa opisująca oczekiwaną arność, a nie metoda ani warunek poprawności wywołania. Sam konstruktor ma Function.length równe 1, a wywoływalny obiekt Function.prototype ma length równe 0.
W funkcji zapisanej w kodzie parametry liczy się od lewej, ale tylko do pierwszego parametru z wartością domyślną dotyczącą całego parametru. Nie liczy się ani jego, ani żadnego następnego parametru. Parametr resztowy ...tail nie jest wliczany. Wzorzec destrukturyzacji liczy się jako jeden parametr; wewnętrzna wartość domyślna w { x = 0 } nie zatrzymuje liczenia, natomiast = {} w { x = 0 } = {} je zatrzymuje.
arguments.length w zwykłej funkcji liczy argumenty faktycznie przekazane w danym wywołaniu, w tym jawnie przekazane undefined. Funkcja strzałkowa nie ma własnego arguments; jeśli zadeklarujesz tylko (...args), to args.length policzy wszystkie jej argumenty. Po nazwanych parametrach tablica resztowa zawiera tylko argumenty pozostałe po ich obsadzeniu.
Dla funkcji z niezmienioną własną właściwością length o skończonej wartości całkowitej bind odejmuje od niej liczbę argumentów związanych z góry, nie schodząc poniżej zera. thisArg się nie liczy. Początkowo length jest właściwością niezapisywalną i niewyliczalną, ale konfigurowalną. Nie używaj jej do walidacji wywołań: JavaScript dopuszcza inną liczbę argumentów, a wynik zależy od funkcji.
Przykłady
{
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);
}Wynik
1 0 1:0 5:2 1 0
`inspect.length` wynosi `1`, bo liczy się tylko `{ x = 0 }`. Związanie argumentu `{}` daje `0`. W `1:0` i `5:2` pierwsza liczba to ogólna liczba przekazanych argumentów, a druga to liczba elementów w `tail`. Jawne `undefined` liczy się jako argument, choć uruchamia wartość domyślną `y`.
Powiązane lekcje
- JavaScript · Lekcja 21 · Zaawansowany · Wersja: 4
Źródła
- 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