Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Standardparameter
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Standard-Funktionsparameter ermöglichen es, benannte Parameter mit Standardwerten zu initialisieren, falls kein Wert oderundefined übergeben wird.
Probieren Sie es aus
function multiply(a, b = 1) { return a * b;}console.log(multiply(5, 2));// Expected output: 10console.log(multiply(5));// Expected output: 5Syntax
function fnName(param1 = defaultValue1, /* …, */ paramN = defaultValueN) { // …}Beschreibung
In JavaScript haben Funktionsparameter standardmäßig den Wertundefined. Es ist jedoch oft nützlich, einen anderen Standardwert festzulegen. Hierbei helfen Standardparameter.
Im folgenden Beispiel, wenn kein Wert fürb bereitgestellt wird, wennmultiply aufgerufen wird, wäre der Wert vonbundefined, wenna * b ausgewertet wird, undmultiply würdeNaN zurückgeben.
function multiply(a, b) { return a * b;}multiply(5, 2); // 10multiply(5); // NaN !Früher war es allgemein üblich, Standardwerte zu setzen, indem man Parameterwerte im Funktionskörper testet und ihnen einen Wert zuweist, wenn sieundefined sind. Im folgenden Beispiel wirdb auf1 gesetzt, wennmultiply nur mit einem Argument aufgerufen wird:
function multiply(a, b) { b = typeof b !== "undefined" ? b : 1; return a * b;}multiply(5, 2); // 10multiply(5); // 5Mit Standardparametern sind Prüfungen im Funktionskörper nicht mehr notwendig. Nun kann1 als Standardwert fürb im Funktionskopf zugewiesen werden:
function multiply(a, b = 1) { return a * b;}multiply(5, 2); // 10multiply(5); // 5multiply(5, undefined); // 5Parameter werden weiterhin von links nach rechts gesetzt und überschreiben Standardparameter selbst dann, wenn es spätere Parameter ohne Standardwerte gibt.
function f(x = 1, y) { return [x, y];}f(); // [1, undefined]f(2); // [2, undefined]Hinweis:Der erste Standardparameter und alle Parameter danach tragen nicht zurlength der Funktion bei.
Die Initialisierer der Standardparameter befinden sich in einem eigenen Gültigkeitsbereich, der ein Elternteil des für den Funktionskörper erstellten Gültigkeitsbereichs ist.
Das bedeutet, dass frühere Parameter in den Initialisierern späterer Parameter referenziert werden können. Funktionen und Variablen, die im Funktionskörper deklariert sind, können jedoch nicht aus den Initialisierern der Standardwerte referenziert werden; ein Versuch dies zu tun führt zu einem Laufzeit-ReferenceError. Dies schließt auch mitvar deklarierte Variablen im Funktionskörper ein.
Zum Beispiel wird die folgende Funktion einenReferenceError auslösen, wenn sie aufgerufen wird, da der Standardparameterwert keinen Zugriff auf den Kind-Gültigkeitsbereich des Funktionskörpers hat:
function f(a = go()) { function go() { return ":P"; }}f(); // ReferenceError: go is not definedDiese Funktion wird den Wert desParametersa ausgeben, da die Variablevar a nur an den Anfang des für den Funktionskörper erstellten Gültigkeitsbereichs gehoben wird und ihr Wert im Elternbereich, der für die Parameterliste erstellt wird, nicht sichtbar ist.
function f(a, b = () => console.log(a)) { var a = 1; b();}f(); // undefinedf(5); // 5Der Standardparameter erlaubt jeden Ausdruck, aber es kann nichtawait oderyield verwendet werden, die die Auswertung des Standardausdrucks pausieren würden. Der Parameter musssynchron initialisiert werden.
async function f(a = await Promise.resolve(1)) { return a;}Hinweis:Da der Standardparameter ausgewertet wird, wenn die Funktion aufgerufen wird, nicht wenn die Funktion definiert wird, hängt die Gültigkeit derawait- undyield-Operatoren von der Funktion selbst ab, nicht von der umgebenden Funktion. Zum Beispiel, wenn die aktuelle Funktion nichtasync ist, wirdawait als Bezeichner geparst und folgt den normalenBezeichner-Syntaxregeln, selbst wenn diese Funktion in einerasync-Funktion geschachtelt ist.
Beispiele
undefined übergeben vs. andere falsy Werte
Im zweiten Aufruf in diesem Beispiel, selbst wenn das erste Argument explizit aufundefined gesetzt ist (jedoch nichtnull oder anderefalsy Werte), bleibt der Wert desnum-Arguments der Standardwert.
function test(num = 1) { console.log(typeof num);}test(); // 'number' (num is set to 1)test(undefined); // 'number' (num is set to 1 too)// test with other falsy values:test(""); // 'string' (num is set to '')test(null); // 'object' (num is set to null)Auswertung zur Aufrufzeit
Das Standardargument wird zurAufrufzeit ausgewertet. Anders als in Python (zum Beispiel) wird jedes Mal, wenn die Funktion aufgerufen wird, ein neues Objekt erstellt.
function append(value, array = []) { array.push(value); return array;}append(1); // [1]append(2); // [2], not [1, 2]Dies gilt auch für Funktionen und Variablen:
function callSomething(thing = something()) { return thing;}let numberOfTimesCalled = 0;function something() { numberOfTimesCalled += 1; return numberOfTimesCalled;}callSomething(); // 1callSomething(); // 2Frühere Parameter sind für spätere Standardparameter verfügbar
Früher definierte Parameter (links) sind für spätere Standardparameter verfügbar:
function greet(name, greeting, message = `${greeting} ${name}`) { return [name, greeting, message];}greet("David", "Hi"); // ["David", "Hi", "Hi David"]greet("David", "Hi", "Happy Birthday!"); // ["David", "Hi", "Happy Birthday!"]Diese Funktionalität kann so approximiert werden, was zeigt, wie viele Randfälle behandelt werden:
function go() { return ":P";}function withDefaults( a, b = 5, c = b, d = go(), e = this, f = arguments, g = this.value,) { return [a, b, c, d, e, f, g];}function withoutDefaults(a, b, c, d, e, f, g) { switch (arguments.length) { case 0: case 1: b = 5; case 2: c = b; case 3: d = go(); case 4: e = this; case 5: f = arguments; case 6: g = this.value; } return [a, b, c, d, e, f, g];}withDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", {value:"=^_^="}, arguments, "=^_^="]withoutDefaults.call({ value: "=^_^=" });// [undefined, 5, 5, ":P", {value:"=^_^="}, arguments, "=^_^="]Destrukturierter Parameter mit Standardwertzuweisung
Sie können Standardwertzuweisungen mit derDestrukturierungs-Syntax verwenden.
Eine gängige Methode dafür ist, ein leeres Objekt/Array als Standardwert für den destrukturierten Parameter festzulegen; zum Beispiel:[x = 1, y = 2] = []. Dies ermöglicht es, der Funktion nichts zu übergeben und dennoch diese Werte vorausgefüllt zu haben:
function preFilledArray([x = 1, y = 2] = []) { return x + y;}preFilledArray(); // 3preFilledArray([]); // 3preFilledArray([2]); // 4preFilledArray([2, 3]); // 5// Works the same for objects:function preFilledObject({ z = 3 } = {}) { return z;}preFilledObject(); // 3preFilledObject({}); // 3preFilledObject({ z: 2 }); // 2Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-function-definitions |