Funktion: length

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die length Dateneigenschaft einer Function-Instanz gibt die Anzahl der Parameter an, die von der Funktion erwartet werden.

In diesem Artikel

Probieren Sie es aus

function func1() {}

function func2(a, b) {}

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

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

Wert

Eine Zahl.

Eigenschaften von Funktion: length

Schreibbar	nein
Aufzählbar	nein
Konfigurierbar	ja

Beschreibung

Die length-Eigenschaft eines Function-Objekts zeigt an, wie viele Argumente die Funktion erwartet, d.h. die Anzahl der formalen Parameter:

Es werden nur Parameter gezählt, die vor dem ersten Parameter mit einem Standardwert liegen.
Ein Destrukturierungsmuster zählt als einzelner Parameter.
Der Rest-Parameter wird ausgeschlossen.

Im Gegensatz dazu ist arguments.length lokal zu einer Funktion und gibt die Anzahl der tatsächlich an die Funktion übergebenen Argumente an.

Der Function-Konstruktor ist selbst ein Function-Objekt. Seine length-Dateneigenschaft hat einen Wert von 1.

Historisch bedingt ist Function.prototype selbst aufrufbar. Die length-Eigenschaft von Function.prototype hat den Wert 0.

Beispiele

Verwendung der Funktion length

js
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