JavaScriptのNull合体演算子(??)とは?||(OR演算子)との違いを解説

JavaScriptのNull合体演算子(??)の解説記事のアイキャッチ

JavaScriptで変数に初期値(デフォルト値)を入れたいとき、昔からよく使われてきたのが ||(OR演算子)です。ただ、最近のコードを読んでいると、ハテナを2つ並べた ??(Null合体演算子)を見かけることが増えてきました。

どちらも「値がなかったら代わりの値を使う」という似た動きをしますが、実は数値の 0 や空文字 “” を扱ったときに結果が変わってきます。ついうっかり || のまま書いてしまって「なぜか 0 が消えて初期値に上書きされる……」とハマりがちなポイントなので、この機会に違いを整理しておきましょう。

Null合体演算子(??)とは?

Null合体演算子(Nullish Coalescing Operator)は、左側の値が null または undefined のときだけ、右側の値を返してくれる演算子です(ES2020で導入されました)。

const name = null;
const displayName = name ?? "ゲスト";

console.log(displayName);
// "ゲスト"

左側の name が null なので、右側の “ゲスト” が使われました。undefined の場合も同じ動きになります。

一方で、左側にちゃんとした値が入っていれば、そのまま左側の値が返ってきます。

const name = "りあぴ";
const displayName = name ?? "ゲスト";

console.log(displayName);
// "りあぴ"

昔からある ||(OR演算子)との違い

では、昔から使われてきた || と何が違うのでしょうか。|| は null や undefined だけでなく、JavaScriptで「偽(falsy)」と判定される値すべてに反応して右側の値を返してしまいます。

JavaScriptで偽(falsy)扱いになる主な値は以下の通りです。

  • null
  • undefined
  • 0(数値のゼロ)
  • “”(空文字)
  • false
  • NaN

つまり、「値として有効なはずの 0 や空文字 “”」まで「値がない」とみなされてしまうのが || の弱点です。

実際にコンソールで動かして見比べてみると違いがはっきり分かります。

const count = 0;

// || を使うと、0 が無視されて 10 になってしまう
console.log(count || 10);
// 10

// ?? を使うと、0 がそのまま有効な値として使われる
console.log(count ?? 10);
// 0

ゲームのスコアや商品の在庫数、アンケートの回答数など、0 という数字そのものに意味があるデータを扱うとき、|| を使っていると気づかないうちにバグを生みやすくなります。

空文字 “” でも同じことが起きます。

const message = "";

// || だと空文字が上書きされる
console.log(message || "メッセージなし");
// "メッセージなし"

// ?? だと空文字のまま通る
console.log(message ?? "メッセージなし");
// ""

「ユーザーが意図的に空欄で保存したデータ」をそのまま扱いたいときは ?? の方が安全です。

オプショナルチェーン(?.)との組み合わせ

Null合体演算子(??)は、以前の記事で紹介したオプショナルチェーン(?.)と組み合わせて使うのが定番です。

外部APIから取得したデータのように、階層が深くて途中の項目が抜けているかもしれないオブジェクトから値を取り出すとき、以下のように書けます。

const user = {
  name: "りあぴ",
  score: 0
  // profile はまだ作られていない
};

// profile.bio は存在しないので「自己紹介未設定」になる
const bio = user.profile?.bio ?? "自己紹介未設定";
console.log(bio);
// "自己紹介未設定"

// score は 0 なので、0 がそのまま表示される
const score = user.score ?? "未計測";
console.log(score);
// 0

?. でエラーを防ぎつつ、最後の仕上げに ?? で表示用のデフォルト値を添える流れは、実際の開発でもよく使われる書き方です。

React開発で ?? が役立つ場面

Reactでコンポーネントを作っていると、親から渡ってくる props や、サーバーから取得したデータの初期値設定で ?? がよく登場します。

たとえば、商品の価格やポイント数を表示するコンポーネントを考えてみます。

function PointBadge({ point }) {
  // point が未取得(undefined)のときだけ「--」にする
  // 0ポイントのときはちゃんと「0 pt」と表示したい
  return (
    <span>保有ポイント:{point ?? "--"} pt</span>
  );
}

もしここを {point || “–“} と書いてしまうと、本当に 0 ポイントのユーザーに対して「保有ポイント:– pt」と表示されてしまいます。数値や真偽値(true / false)が入りうる場所では、迷わず ?? を使うようにすると安心です。

どう使い分ければいい?(迷ったときの基準)

最初からすべての場面を厳密に覚えようとしなくても大丈夫です。普段コードを書くときは、次の基準だけ意識しておけば困りません。

  • 基本は ?? を使う(null と undefined のときだけ初期値にしたい場合がほとんどなため)
  • 空文字 “” や 0 のときも初期値に置き換えたい場合だけ || を使う(例:フォームが未入力(””)のときに「未入力」と出したいときなど)

昔からの慣れでつい || を書いてしまいがちですが、今は「デフォルト値といえばまず ??」くらいに考えておくと安全です。

コメント

タイトルとURLをコピーしました