Funktion: length

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die length Daten-Eigenschaft einer Function-Instanz gibt die Anzahl der erwarteten Parameter der Funktion an.

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:

Nur Parameter vor dem ersten mit einem Standardwert werden gezählt.
Ein Destrukturierungsmuster zählt als ein einzelner Parameter.
Der Rest-Parameter wird ausgeschlossen.

Im Gegensatz dazu ist arguments.length lokal in 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 den Wert 1.

Aus historischen Gründen ist Function.prototype selbst aufrufbar. Die length-Eigenschaft von Function.prototype hat den Wert 0.

Beispiele

Verwendung von function 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

Specification
ECMAScript® 2025 Language Specification # sec-function-instances-length

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Function