Logical OR assignment (||=)
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Thelogical OR assignment (||=
) operator only evaluates the right operand and assigns to the left if the left operand isfalsy.
Try it
const a = { duration: 50, title: "" };a.duration ||= 10;console.log(a.duration);// Expected output: 50a.title ||= "title is empty.";console.log(a.title);// Expected output: "title is empty."
Syntax
x ||= y
Description
Logical OR assignmentshort-circuits, meaning thatx ||= y
is equivalent tox || (x = y)
, except that the expressionx
is only evaluated once.
No assignment is performed if the left-hand side is not falsy, due to short-circuiting of thelogical OR operator. For example, the following does not throw an error, despitex
beingconst
:
const x = 1;x ||= 2;
Neither would the following trigger the setter:
const x = { get value() { return 1; }, set value(v) { console.log("Setter called"); },};x.value ||= 2;
In fact, ifx
is not falsy,y
is not evaluated at all.
const x = 1;x ||= console.log("y evaluated");// Logs nothing
Examples
Setting default content
If the "lyrics" element is empty, display a default value:
document.getElementById("lyrics").textContent ||= "No lyrics.";
Here the short-circuit is especially beneficial, since the element will not be updated unnecessarily and won't cause unwanted side-effects such as additional parsing or rendering work, or loss of focus, etc.
Note: Pay attention to the value returned by the API you're checking against. If an empty string is returned (afalsy value),||=
must be used, so that "No lyrics." is displayed instead of a blank space. However, if the API returnsnull
orundefined
in case of blank content,??=
should be used instead.
Specifications
Specification |
---|
ECMAScript® 2026 Language Specification # sec-assignment-operators |