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
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.
null || undefined ?? "foo"; // raises a SyntaxError
true && undefined ?? "foo"; // raises a SyntaxError
Stattdessen verwenden Sie Klammern, um die Priorität explizit zu kennzeichnen:
(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.
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 (||
):
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.
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):
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.
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.
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