Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.length

fn.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.

Źródła