Nullish coalescing-Operator (??)

Baseline Widely available

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

Der nullish coalescing (??)-Operator ist ein logischer Operator, der seinen rechten Operanden zurückgibt, wenn sein linker Operand null oder undefined ist, und andernfalls seinen linken Operanden zurückgibt.

Probieren Sie es aus

Syntax

js
leftExpr ?? rightExpr

Beschreibung

Der nullish coalescing-Operator kann als ein Sonderfall des logischen OR (||) Operators gesehen werden. Letzterer gibt den rechten Operanden zurück, wenn der linke Operand ein beliebiger falsy Wert ist, nicht nur null oder undefined. Mit anderen Worten: Wenn Sie || verwenden, um einem anderen Variable foo einen Standardwert zuzuweisen, können unerwartete Verhaltensweisen auftreten, wenn Sie einige falsy-Werte als nutzbar ansehen (z. B. '' oder 0). Siehe unten für mehr Beispiele.

Der nullish coalescing-Operator hat die fünftniedrigste Operator-Priorität, direkt niedriger als || und direkt höher als der bedingte (ternäre) Operator.

Es ist nicht möglich, sowohl den AND (&&) als auch OR (||) Operator direkt mit ?? zu kombinieren. In solchen Fällen wird ein Syntaxfehler ausgelöst.

js
null || undefined ?? "foo"; // raises a SyntaxError
true && undefined ?? "foo"; // raises a SyntaxError

Stattdessen verwenden Sie Klammern, um die Priorität explizit zu kennzeichnen:

js
(null || undefined) ?? "foo"; // returns "foo"

Beispiele

Verwendung des nullish coalescing-Operators

In diesem Beispiel werden wir Standardwerte bereitstellen, aber andere als null oder undefined Werte behalten.

js
const nullValue = null;
const emptyText = ""; // falsy
const someNumber = 42;

const valA = nullValue ?? "default for A";
const valB = emptyText ?? "default for B";
const valC = someNumber ?? 0;

console.log(valA); // "default for A"
console.log(valB); // "" (as the empty string is not null or undefined)
console.log(valC); // 42

Zuweisung eines Standardwerts zu einer Variablen

Früher war ein gängiges Muster, um einer Variablen einen Standardwert zuzuweisen, die Verwendung des logischen OR-Operators (||):

js
let foo;

// foo is never assigned any value so it is still undefined
const someDummyText = foo || "Hello!";

Da || jedoch ein boolescher logischer Operator ist, wurde der linke Operand für die Bewertung in einen Booleschen Wert umgewandelt und jeder falsy Wert (einschließlich 0, '', NaN, false, etc.) wurde nicht zurückgegeben. Dieses Verhalten kann unerwartete Konsequenzen verursachen, wenn Sie 0, '' oder NaN als gültige Werte betrachten.

js
const count = 0;
const text = "";

const qty = count || 42;
const message = text || "hi!";
console.log(qty); // 42 and not 0
console.log(message); // "hi!" and not ""

Der nullish coalescing-Operator vermeidet dieses Problem, indem er nur den zweiten Operanden zurückgibt, wenn der erste entweder null oder undefined ist (aber keine anderen falsy-Werte):

js
const myText = ""; // An empty string (which is also a falsy value)

const notFalsyText = myText || "Hello world";
console.log(notFalsyText); // Hello world

const preservingFalsy = myText ?? "Hi neighborhood";
console.log(preservingFalsy); // '' (as myText is neither undefined nor null)

Kurzschlusslogik

Wie die logischen 'OR'- und 'AND'-Operatoren wird der rechte Ausdruck nicht ausgewertet, wenn der linke Ausdruck weder null noch undefined ist.

js
function a() {
  console.log("a was called");
  return undefined;
}
function b() {
  console.log("b was called");
  return false;
}
function c() {
  console.log("c was called");
  return "foo";
}

console.log(a() ?? c());
// Logs "a was called" then "c was called" and then "foo"
// as a() returned undefined so both expressions are evaluated

console.log(b() ?? c());
// Logs "b was called" then "false"
// as b() returned false (and not null or undefined), the right
// hand side expression was not evaluated

Beziehung zum optionalen Verkettungsoperator (?.)

Der nullish coalescing-Operator behandelt undefined und null als spezifische Werte. Dies tut auch der optionale Verkettungsoperator (?.), der nützlich ist, um auf eine Eigenschaft eines Objekts zuzugreifen, das null oder undefined sein kann. Durch die Kombination dieser beiden Operatoren können Sie sicher auf eine Eigenschaft eines Objekts zugreifen, das nullish sein kann, und einen Standardwert bereitstellen, falls dies der Fall ist.

js
const foo = { someFooProp: "hi" };

console.log(foo.someFooProp?.toUpperCase() ?? "not available"); // "HI"
console.log(foo.someBarProp?.toUpperCase() ?? "not available"); // "not available"

Spezifikationen

Specification
ECMAScript Language Specification
# prod-CoalesceExpression

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch