論理和代入 (||=)

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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

論理和代入演算子 (x ||= y) は、x偽値である場合にのみ代入を行います。

試してみましょう

const a = { duration: 50, title: "" };

a.duration ||= 10;
console.log(a.duration);
// Expected output: 50

a.title ||= "title is empty.";
console.log(a.title);
// Expected output: "title is empty."

構文

js
expr1 ||= expr2;

解説

短絡評価 (ショートサーキット)

論理和演算子は次のように動作します。

js
x || y;
// x が真値の場合 x を返します
// x が真値ではない場合 y を返します

論理和演算子は、1 つ目のオペランドがまだ結果を決定していない場合にのみ、2 つ目のオペランドの評価を行う短絡評価をします。

論理和代入も同様に短絡評価され、右辺の評価が行われる論理演算の場合にのみ代入が行われます。言い替えれば、x ||= y は以下と等価です。

js
x || (x = y);

そして、常に代入が行われる以下と等価ではありません。

js
x = x || y;

なお、この動作は、数学的な代入演算子やビット代入演算子とは異なることに注意してください。

既定の内容を設定する

"lyrics" 要素が空の場合は、既定値を表示します。

js
document.getElementById("lyrics").textContent ||= "No lyrics.";

ここでの短絡評価は、要素が不必要に更新されることがなく、追加のパースやレンダリング作業、フォーカスの損失などの望ましくない副作用を引き起こすことがないので、特に有益です。

注意: チェック対象の API が返す値に注意してください。空の文字列 (偽値) が返される場合は、||= を使用する必要があります。それ以外の場合 (返値が null または undefined の場合) は ??= 演算子を使用してください。

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-assignment-operators

ブラウザーの互換性

関連情報