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

JavaScript / コードを試す

入れ子のオブジェクトを安全に扱う

深いところを辿ると途中で落ちます。オプショナルチェーンで落ちないようにする方法、分割代入で必要な値だけ取り出す書き方、既定値の付け方と ?? と || の違いを確かめます。

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

実際のデータは入れ子になっています。深く辿るのは、そのままだと危険です。

example.js

const data = { user: { profile: { name: 'あ' } } };

console.log(data.user.profile.name);
固定例の期待出力 · Node 24.22.3
あ
表示用コードUTF-8 · LF

途中の鍵が無いと落ちます。

javascript失敗・注意の例

const data = { user: { profile: { name: 'あ' } } };

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

data.user.address が undefined で、その city を読もうとしたからです。 落ちるのは最後の1段で、原因はその手前にあります。 → Cannot read properties of undefined

?. で落ちないようにする

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

example.js

const data = { user: { profile: { name: 'あ' } } };

console.log(data.user?.address?.city);
console.log(data.user?.profile?.name);
固定例の期待出力 · Node 24.22.3
undefined
あ
表示用コードUTF-8 · LF

これをオプショナルチェーンと呼びます。

止まるのは null と undefined のときだけです。 0 や空文字では止まりません。

example.js

const data = { count: 0, label: '' };

console.log(data.count?.toFixed(1));
console.log(data.label?.length);
固定例の期待出力 · Node 24.22.3
0.0
0
表示用コードUTF-8 · LF

関数と配列にも使える

example.js

const api = { load: () => 'あ' };

console.log(api.load?.());
console.log(api.save?.());

const list = null;

console.log(list?.[0]);
固定例の期待出力 · Node 24.22.3
あ
undefined
undefined
表示用コードUTF-8 · LF

?.() は「関数があれば呼ぶ」、?.[] は「あれば取り出す」です。 無い関数を呼んでも落ちません。

使いすぎない

javascript失敗・注意の例
console.log(data?.user?.profile?.name);
表示用コードUTF-8 · LF

全部に付けるのは、考えるのをやめている合図です。 data が必ずあると分かっているなら、そこに ?. は要りません。

本当は「無いはずがない」ところが undefined になっていても、?. が黙って隠します。 付けるのは「無いことがありうる」と分かっている場所だけにしてください。

既定値を付ける

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

example.js

const data = { user: {} };

console.log(data.user?.address?.city ?? '未設定');
固定例の期待出力 · Node 24.22.3
未設定
表示用コードUTF-8 · LF

|| との違い

ここは必ず踏む落とし穴です。

example.js

const settings = { count: 0, label: '', flag: false };

console.log(settings.count ?? 10, settings.count || 10);
console.log(JSON.stringify(settings.label ?? 'なし'), JSON.stringify(settings.label || 'なし'));
console.log(settings.flag ?? true, settings.flag || true);
固定例の期待出力 · Node 24.22.3
0 10
"" "なし"
false true
表示用コードUTF-8 · LF

|| は0・空文字・false も「無い」と見なします。

  • 件数が 0 なのに 10 になる
  • 入力が空なのに「なし」に置き換わる
  • 設定を false にしたのに true になる

「値が無いとき」の既定値は ??、「偽のとき」の代替は ||。 迷ったら ?? です。

分割代入で取り出す

必要な値だけを、名前を付けて取り出せます。

example.js

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

const { name, age } = user;

console.log(name, age);
固定例の期待出力 · Node 24.22.3
あ 20
表示用コードUTF-8 · LF

入れ子も取り出せます。

example.js

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

const { address: { city } } = user;

console.log(city);
固定例の期待出力 · Node 24.22.3
東京
表示用コードUTF-8 · LF

ただし address が無いと落ちます。 深い分割代入は、 あることが確実なときだけにしてください。

名前を変える・既定値を付ける

example.js

const user = { name: 'あ' };

const { name: userName, nothing = '既定値' } = user;

console.log(userName);
console.log(nothing);
固定例の期待出力 · Node 24.22.3
あ
既定値
表示用コードUTF-8 · LF
  • name: userName … 別の名前で受け取る。他の変数と衝突するときに使う
  • nothing = '既定値' … 無いときだけ使われる

既定値が働くのはundefined のときだけです。null では働きません。

example.js

const user = { a: null, b: undefined };

const { a = '既定値', b = '既定値' } = user;

console.log(a);
console.log(b);
固定例の期待出力 · Node 24.22.3
null
既定値
表示用コードUTF-8 · LF

?? は null でも働き、分割代入の既定値は働きません。 ここが違います。

関数の引数で使う

分割代入がいちばん効くのは、関数の受け口です。

example.js

function show({ name, city = '不明' }) {
  return `${name}(${city})`;
}

console.log(show({ name: 'あ', city: '東京' }));
console.log(show({ name: 'い' }));
固定例の期待出力 · Node 24.22.3
あ(東京)
い(不明)
表示用コードUTF-8 · LF

何を使うのかが、呼び出し側から見えます。 引数の順番を覚えなくてよくなるのも利点です。

まとめ

  • 途中の鍵が無いと落ちる。原因は落ちた場所の手前
  • ?. はnull と undefined のときだけ止まる。0 や空文字では止まらない
  • 全部に ?. を付けない。 隠すべきでない間違いまで隠れる
  • 既定値は ??。|| は 0・空文字・false も置き換える
  • 分割代入の既定値は undefined のときだけ働く(null では働かない)
  • 関数の引数で使うと、何を使うのかが呼び出し側から見える

次に学ぶ

オブジェクトの中身を全部まとめて扱う方法を学びます。 Object.keys() / values() / entries() で回し、 配列のメソッドと組み合わせて変換する形までやります。

→ 第3回: オブジェクトを回す・変換する

出典

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