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.
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
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
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-function-instances-length |