できない.dev

Null 合体演算子 (??)

別名: ?? / nullish coalescing / Nullish coalescing operator / ヌル合体演算子

Null 合体演算子 ?? は、左辺が null か undefined のときだけ右辺を返す JavaScript の演算子である。
0 や空文字を残したまま既定値を入れられるので、|| による既定値の代わりに使う。

公開: 更新:

定義

Null 合体演算子 ?? は、左辺が null か undefined のときに右辺を返し、それ以外なら左辺を返す JavaScript の演算子である。
値が無いときの既定値を入れる場面で使う。
a ?? b の b は、a が null でも undefined でもなければ評価されない。

詳細

MDN(新しいタブで開く) のとおり、|| は 0・空文字・false などの falsy な値でも右辺に切り替わる。
?? が右辺を選ぶのは null と undefined のときだけである。

const count = 0;
console.log(count || 42); // 42
console.log(count ?? 42); // 0

オプショナルチェーンの ?. と組み合わせると、途中が欠けたときの既定値まで 1 行で書ける。
TypeScript では、?? を通した結果の型から null と undefined が外れる。
React の input で value が undefined になるのを防ぐときにも使い、その例は controlled / uncontrolled input 警告 にある。

よくある誤解

?? は && や || と括弧なしで並べられない。
a || b ?? c は SyntaxError になるので、(a || b) ?? c のように括弧で順序を決める。

ES2020 で入った構文なので、古い実行環境向けには変換が要る。
node_modules の中の依存が ?? のまま配布されていると、変換対象から外れた場合にそのまま残る。

関連

?. と ?? を変換する Babel の設定は babel-loader で node_modules 内のパッケージが変換できない が扱う。
undefined の扱いは undefined にまとめている。