WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Logische ODER-Zuweisung (||=)

Der Operator ||= weist den Wert der rechten Seite nur zu, wenn der aktuelle Wert des Ziels falsy ist. Er wertet bedingt aus und wertet die Zielreferenz nur einmal aus.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

target ||= expression

target ||= expression liest den Wert des Ziels und prüft ihn mit ToBoolean. Ist er truthy, gibt der Operator ihn zurück, ohne expression auszuwerten oder eine Zuweisung vorzunehmen. Andernfalls wertet er die rechte Seite aus, weist deren Wert zu und gibt ihn zurück; das Ergebnis muss kein boolean sein.

Zu den falsy-Werten gehören false, 0, -0, 0n, "", NaN, null und undefined. Daher kann ||= eine gültige Null oder eine leere Zeichenfolge überschreiben. Verwende ??=, wenn nur null und undefined einen fehlenden Wert bedeuten sollen. Der Operator |= führt ein bitweises OR aus und ist kein Ersatz für ||=.

Die Zielreferenz wird nur einmal ausgewertet. obj[key()] ||= value ruft key() einmal auf, anders als die naive Umschreibung obj[key()] = obj[key()] || value. Beim Lesen kann ein Getter ausgeführt werden; der Setter wird jedoch übersprungen, wenn der gelesene Wert truthy ist. Das Ziel muss ein gültiges Zuweisungsziel sein; eine nicht deklarierte Variable lässt sich auf diese Weise nicht initialisieren.

Der Operator gehört zu ECMAScript 2021. Er ist Sprachsyntax und keine Web API. Prüfe für die Bereitstellung die Syntaxunterstützung in den Ziel-Engines oder transformiere den Code; Node 24 in einem Repository belegt keine Browserunterstützung.

Beispiele

let calls = 0;
function fallback() {
  calls += 1;
  return "Guest";
}

const profile = { name: "", role: "admin" };
profile.name ||= fallback();
profile.role ||= fallback();

let limit = 0;
limit ||= 10;

console.log(profile.name);
console.log(profile.role);
console.log(calls);
console.log(limit);

Ergebnis

Guest
admin
1
10

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen