このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
論理和代入演算子 (||=)
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年9月.
論理和代入演算子 (||=) は、左オペランドが偽値の場合にのみ右オペランドを評価し、左オペランドに代入します。
試してみましょう
const a = { duration: 50, title: "" };a.duration ||= 10;console.log(a.duration);// 予想される結果: 50a.title ||= "title is empty.";console.log(a.title);// 予想される結果: "title is empty."構文
js
x ||= y解説
論理和代入演算子は短絡評価を行うため、x ||= y はx || (x = y) と同等です。ただし、式x は一度だけ評価されます。
左辺が偽値でない場合、論理和演算子の短絡が発生するため代入は実行されません。例えば、x がconst であっても、以下のコードはエラーが発生しません。
js
const x = 0;x ||= 2;次のコードもセッターを起動しません。
js
const x = { get value() { return 1; }, set value(v) { console.log("セッターが呼び出されました"); },};x.value ||= 2;そして、常に代入が行われる以下と等価ではありません。
js
const x = 1;x ||= console.log("y が評価されました");// 何もログ出力されない例
既定の内容を設定する
"lyrics" 要素が空の場合は、既定値を表示します。
js
document.getElementById("lyrics").textContent ||= "No lyrics.";ここでの短絡評価は、要素が不必要に更新されることがなく、追加のパースやレンダリング作業、フォーカスの損失などの望ましくない副作用を引き起こすことがないので、特に有益です。
注意: チェック対象の API が返す値に注意してください。空の文字列（偽値）が返される場合は、||= を使用する必要があります。それ以外の場合 (返値がnull またはundefined の場合) は??= 演算子を使用してください。
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-assignment-operators |