CKTIS / JavaScript
`Function.length` und die Stelligkeit von Funktionen
`fn.length` beschreibt die erwartete Stelligkeit einer Funktion; `arguments.length` zählt die bei einem konkreten Aufruf übergebenen Argumente.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
fn.length
Function.length
Function.prototype.length
fn.bind(thisArg, ...presetArgs).length
arguments.lengthDie Stelligkeit einer Funktion bezieht sich auf ihre Parameterzahl. In JavaScript beschreibt die numerische Eigenschaft fn.length die erwartete Stelligkeit. Sie ist weder eine Methode noch eine Aufrufvorgabe. Der eingebaute Konstruktor selbst hat Function.length gleich 1; beim aufrufbaren Function.prototype ist length gleich 0.
Bei einer im Quellcode definierten Funktion zählt man von links bis zum ersten Parameter mit einem Standardwert für den gesamten Parameter. Dieser und alle folgenden Parameter zählen nicht. Ein Restparameter wie ...tail zählt nie. Ein Destrukturierungsmuster zählt als ein Parameter: Der innere Standardwert in { x = 0 } beendet die Zählung nicht, das äußere = {} in { x = 0 } = {} dagegen schon.
In einer gewöhnlichen Funktion zählt arguments.length die tatsächlich beim jeweiligen Aufruf übergebenen Argumente, einschließlich eines expliziten undefined. Pfeilfunktionen haben kein eigenes arguments. Ist (...args) ihre gesamte Parameterliste, zählt args.length alle Argumente. Nach benannten Parametern enthält das Rest-Array nur die übrigen Argumente.
Bei einer Funktion mit unveränderter eigener length-Eigenschaft und endlichem ganzzahligem Wert zieht bind die Zahl der vorab gebundenen Argumente ab, jedoch nicht unter null. thisArg zählt nicht mit. Die ursprüngliche Eigenschaft length ist nicht schreibbar und nicht aufzählbar, aber konfigurierbar. Sie eignet sich nicht zur Aufrufvalidierung: JavaScript erlaubt eine andere Argumentzahl, und das Ergebnis hängt von der Funktion ab.
Beispiele
{
function inspect({ x = 0 }, y = 10, z, ...tail) {
return `${arguments.length}:${tail.length}`;
}
console.log(inspect.length);
console.log(inspect.bind(null, {}).length);
console.log(inspect({}));
console.log(inspect({}, undefined, 3, 4, 5));
console.log(Function.length);
console.log(Function.prototype.length);
}Ergebnis
1 0 1:0 5:2 1 0
`inspect.length` ist `1`, da nur `{ x = 0 }` zählt. Durch Vorabbindung von `{}` sinkt der Wert auf `0`. Bei `1:0` und `5:2` zählt die erste Zahl alle übergebenen Argumente, die zweite nur die Elemente in `tail`. Das explizite `undefined` zählt mit, obwohl es den Standardwert für `y` auslöst.
Zugehörige Lektionen
- JavaScript · Lektion 21 · Fortgeschritten · Version: 4
Quellen
- ECMAScript® 2024 Language Specification — Static Semantics: ExpectedArgumentCount
- ECMAScript® 2024 Language Specification — Function Instances: length
- ECMAScript® 2024 Language Specification — Function.prototype.bind
- Function: length - JavaScript | MDN
- The arguments object - JavaScript | MDN
- Rest parameters - JavaScript | MDN