本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

?. と ?? — 無いかもしれない値を安全に読む

?. は null と undefined のときだけ止まります。?? は 0 や空文字を既定値で潰しません。連鎖が丸ごと止まること、?. が守ってくれない場面まで実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

?. は、左が null か undefined なら、そこで止まって undefined を返します。

example.js

const user = { name: 'あ', address: { city: '東京' } };
const empty = {};

console.log(user.address?.city);
console.log(empty.address?.city);

try {
  console.log(empty.address.city);
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
東京
undefined
TypeError: Cannot read properties of undefined (reading 'city')
表示用コードUTF-8 · LF

同じ場所で、落ちるかundefined になるかが変わります。

書ける場所は3つ

example.js

const source = { a: { b: 1 }, list: [10, 20], fn: () => 'よんだ' };
const nothing = null;

console.log(source?.a?.b, nothing?.a?.b);
console.log(source.list?.[1], nothing?.[0]);
console.log(source.fn?.(), source.missing?.());
固定例の期待出力 · Node 24.22.3
1 undefined
20 undefined
よんだ undefined
表示用コードUTF-8 · LF
書き方 何を守るか
a?.b 鍵で読む
a?.[i] 添字や変数で読む
a?.() 呼ぶ

a?.b と a[b] を混ぜるときは a?.[b] です。 a?[b] とは書けません。

止まるのは2つの値のときだけ

example.js

for (const value of [null, undefined, 0, '', false]) {
  console.log(JSON.stringify(value), '->', String(value?.constructor?.name));
}
固定例の期待出力 · Node 24.22.3
null -> undefined
undefined -> undefined
0 -> Number
"" -> String
false -> Boolean
表示用コードUTF-8 · LF

0 も空文字も false も、止まりません。 「値が無い」と「値が偽になる」は別のことです。

止まると、その先も評価されない

example.js

let called = 0;
const arg = () => {
  called++;
  return 1;
};

const nothing = null;

console.log(nothing?.method(arg()));
console.log('引数を評価した回数:', called);
固定例の期待出力 · Node 24.22.3
undefined
引数を評価した回数: 0
表示用コードUTF-8 · LF

引数すら評価されません。 これを短絡評価と呼びます。

連鎖は丸ごと止まる

ここは誤解されがちです。

example.js

const source = {};

console.log(source.a?.b.c.d);
固定例の期待出力 · Node 24.22.3
undefined
表示用コードUTF-8 · LF

?. の後ろに ?. が無くても落ちません。 a が無かった時点で、その連鎖の残り全部が飛ばされます。

ただし、括弧で切ると別の式になります。

javascript失敗・注意の例

const source = {};

console.log((source.a?.b).c);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'c')
表示用コードUTF-8 · LF

括弧で囲むと、そこで連鎖が終わります。 意味もなく囲まないでください。

?? — 既定値を入れる

?? は、左が null か undefined のときだけ右を返します。

example.js

const values = [null, undefined, 0, '', false, 'あ'];

for (const value of values) {
  console.log(JSON.stringify(value), '|', JSON.stringify(value ?? '既定'), '|', JSON.stringify(value || '既定'));
}
固定例の期待出力 · Node 24.22.3
null | "既定" | "既定"
undefined | "既定" | "既定"
0 | 0 | "既定"
"" | "" | "既定"
false | false | "既定"
"あ" | "あ" | "あ"
表示用コードUTF-8 · LF

|| は 0 と空文字と false も潰します。 これが古くからある事故のもとです。

example.js

const settings = { retry: 0, timeout: null };

console.log(settings.retry ?? 3);
console.log(settings.retry || 3);
console.log(settings.timeout ?? 1000);
固定例の期待出力 · Node 24.22.3
0
3
1000
表示用コードUTF-8 · LF

「再試行しない」という設定の 0 が、|| だと3回に化けます。 設定値の既定は ?? で書いてください。

「空文字も既定に倒したい」ときは || が正しい選択です。値として 0 や空文字が意味を持つかどうかで決めます。

??= — 無いときだけ入れる

example.js

const options = { a: 0, b: null };

options.a ??= 9;
options.b ??= 9;
options.c ??= 9;

console.log(JSON.stringify(options));
固定例の期待出力 · Node 24.22.3
{"a":0,"b":9,"c":9}
表示用コードUTF-8 · LF

||= にすると 0 まで書き換わります。

javascript失敗・注意の例

const options = { a: 0, b: null };

options.a ||= 9;
options.b ||= 9;

console.log(JSON.stringify(options));
固定例の期待出力 · Node 24.22.3
{"a":9,"b":9}
表示用コードUTF-8 · LF

→ 関数の引数 — 既定値・可変長・分割代入

?? は && || と並べられない

javascript
const x = a || b ?? c;
表示用コードUTF-8 · LF

これは構文として読めません。 括弧を書けば通ります。

javascript
const x = (a || b) ?? c;
表示用コードUTF-8 · LF

優先順位が直感と食い違うため、言語のほうで括弧を強制しています。構文の誤りなので、このページでは実行例にできません。

?. が守ってくれないもの

関数でない値を呼ぶ

example.js

const notFunction = { f: 1 };

try {
  notFunction.f?.();
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
TypeError: notFunction.f is not a function
表示用コードUTF-8 · LF

?.() が見ているのはあるか無いかだけです。 関数かどうかは見ていません。 → TypeError: x is not a function

宣言されていない名前

example.js

try {
  console.log(notDeclared?.a);
} catch (error) {
  console.log(error.name + ': ' + error.message);
}

console.log(typeof notDeclared);
固定例の期待出力 · Node 24.22.3
ReferenceError: notDeclared is not defined
undefined
表示用コードUTF-8 · LF

?. は値を見るもので、名前を探すものではありません。 名前の存在を調べるなら typeof です。 → ReferenceError: x is not defined

よくある間違い:とりあえず全部に付ける

javascript失敗・注意の例

function total(order) {
  return order?.items?.reduce?.((sum, item) => sum + item?.price, 0);
}

console.log(total({ items: [{ price: 1 }, { price: 2 }] }));
console.log(total(null));
console.log(total({}));
固定例の期待出力 · Node 24.22.3
3
undefined
undefined
表示用コードUTF-8 · LF

落ちなくはなりました。ですが、items を渡し忘れても undefined が静かに返ります。 その undefined は、呼んだ側のもっと遠い場所で落ちます。

?. は欠けていて当たり前の場所にだけ付けてください。 あるはずのものが無いなら、そこで落としたほうが直しやすいです。

example.js

function total(order) {
  const items = order.items ?? [];
  return items.reduce((sum, item) => sum + item.price, 0);
}

console.log(total({ items: [{ price: 1 }, { price: 2 }] }));
console.log(total({}));
固定例の期待出力 · Node 24.22.3
3
0
表示用コードUTF-8 · LF

→ 入れ子のオブジェクトを安全にたどる

まとめ

  • ?. が止まるのはnull と undefined のときだけ。0 や空文字では止まらない
  • 書ける形は a?.b / a?.[i] / a?.() の3つ
  • 止まると残りの連鎖ごと飛ばされる。括弧で囲むとそこで切れる
  • ?? は || と違い、0 と空文字と false を潰さない
  • ?? を && || と並べるには括弧が要る
  • ?.() は関数かどうかを見ていない。未宣言の名前も守れない
  • 欠けていて当たり前の場所にだけ付ける

出典

この教材の原文(Markdown・別タブ)