CKTIS / JavaScript
Function.length — liczba parametrów funkcji
Właściwość length funkcji opisuje liczbę jej parametrów według reguł deklaracji, a nie liczbę argumentów przekazanych przy wywołaniu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
fn.length
Function.lengthfn.length odczytuje liczbę parametrów funkcji. Sam konstruktor Function też jest funkcją: Function.length wynosi 1. Jest to właściwość danych, nie metoda.
Liczone są tylko parametry przed pierwszym parametrem z wartością domyślną. Każdy wzorzec destrukturyzacji liczy się jako jeden parametr; parametr rest nie jest liczony. Standardowa właściwość length jest niezapisywalna i niewyliczalna, ale konfigurowalna.
Natomiast arguments.length wewnątrz zwykłej funkcji podaje liczbę argumentów rzeczywiście przekazanych w danym wywołaniu. Może być ona większa lub mniejsza niż fn.length; nie należy mylić tych dwóch wartości.
Przykłady
function inspect({ value }, scale = 1, ...extra) {
console.log(arguments.length);
}
console.log(Function.length);
console.log(inspect.length);
inspect({ value: 7 }, 2, 9);
console.log((({ x }, [y]) => {}).length);
console.log(((...items) => {}).length);Wynik
1 1 3 2 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.