JavaScriptのオプショナルチェーン(?.)とは?

JavaScriptのオプショナルチェーン(?.)の解説記事のアイキャッチ

JavaScriptでWebAPIから取得したデータや、階層が深いオブジェクトから値を取り出すとき、「途中のプロパティが存在しなくてエラーになってしまった!」という経験はありませんか?

かつては if 文や &&、in 演算子などを何重にも書いて安全確認をしていましたが、現在のJavaScriptではオプショナルチェーン(?.)を使うだけで、スッキリと安全に書けるようになっています。

この記事では、オプショナルチェーンの基本的な使い方と、React開発でどのように役立つのかを初心者向けに解説します。

オプショナルチェーン(?.)とは?

オプショナルチェーン(Optional Chaining)は、オブジェクトのプロパティやメソッドにアクセスする際、途中の値が null または undefined であってもエラーを出さずに undefined を返してくれるJavaScriptの構文です(ES2020で導入されました)。

通常のドット(.)の代わりに、ハテナを付けた ?. を使って記述します。

const user = {
  name: "りあぴ",
  profile: {
    sns: {
      x: "@riapi_js"
    }
  }
};

// 存在する場合:そのまま値が取れる
console.log(user.profile?.sns?.x);
// "@riapi_js"

// 存在しない場合:エラーにならず undefined になる
console.log(user.address?.city);
// undefined

もしここで通常の . を使って user.address.city と書いてしまうと、address が undefined であるため TypeError: Cannot read properties of undefined というエラーが発生し、プログラムが止まってしまいます。

昔はどう書いていたの?(if 文や &&、in 演算子の苦労)

オプショナルチェーンが登場する前は、外部APIから受け取ったデータ(すべての項目が揃っているか保証がないデータ)を扱う際、親から順番に「存在するかどうか」をすべて確認する必要がありました。

昔の書き方その1:if 文を入れ子にする

let city;
if (user && user.address && user.address.city) {
  city = user.address.city;
}

昔の書き方その2:&&(論理積)でつなぐ

const city = user && user.address && user.address.city;

階層が深くなればなるほど、user && user.profile && user.profile.sns && … のように同じ変数名を何度も書く必要があり、コードが長くなって読みづらくなっていました。

昔の書き方その3:in 演算子でプロパティの存在を確認する

値が 0 や空文字 “” の場合でも「プロパティ自体が存在するか」を厳密に調べたいときは、in 演算子(または hasOwnProperty)を使って以下のように書くこともありました。

let city;
if (user && 'address' in user && user.address && 'city' in user.address) {
  city = user.address.city;
}

プロパティ名を文字列(’address’ など)で書く必要があるうえ、やはり階層の数だけチェックが増えるため、かなり大変な書き方でした。

今の書き方:オプショナルチェーン(?.)

オプショナルチェーンを使えば、上のコードがたった1行で済みます。

const city = user?.address?.city;

途中で null や undefined に出会った時点で評価をストップし、安全に undefined を返してくれます。

※ちなみに: if (user.address.city) のような昔の書き方だと、値が 0 や “”(空文字)だった場合にも「存在しない(false)」と判定されてしまいますが、オプショナルチェーン(user.address?.city)なら 0 や “” もそのまま正しく取得できます。

配列や関数の呼び出しにも使える

オプショナルチェーンはオブジェクトのプロパティだけでなく、配列の要素や関数の呼び出しにも使えます。

配列へのアクセス(?.[])

const list = null;

// 配列が存在しない場合でもエラーにならない
console.log(list?.[0]);
// undefined

関数の呼び出し(?.())

const actions = {
  sayHello: () => console.log("こんにちは!")
};

// 存在する関数は実行される
actions.sayHello?.();
// "こんにちは!"

// 存在しない関数を呼んでもエラーにならない
actions.sayBye?.();
// (エラーにならず何も起きない)

Null合体演算子(??)との組み合わせ

オプショナルチェーンは、値が null や undefined のときにデフォルト値を指定できる Null合体演算子(??) と組み合わせて使うのが定番です。

const user = {
  name: "りあぴ"
  // address は未設定
};

// address.city がなければ「未登録」にする
const city = user.address?.city ?? "未登録";

console.log(city);
// "未登録"

このように書くことで、「データが欠けていてもエラーにならず、画面には親切な代替テキストを表示する」という処理が1行で書けます。

?? と || の違いや使い分けは、Null合体演算子(??)と ||(OR演算子)の違いの記事で詳しく解説しています。

React開発でオプショナルチェーンが役立つ場面

ReactでWebアプリを作っていると、オプショナルチェーンは毎日のように使います。特に役立つのが外部APIからデータを取得して画面に表示するときです。

Reactでは、通信が終わる前(データが届く前)にも最初の画面描画(レンダリング)が走ります。

function UserProfile({ user }) {
  // 通信完了前は user が null や undefined の可能性がある
  return (
    <div>
      <h2>{user?.name ?? "読み込み中..."}</h2>
      <p>住んでいる街:{user?.address?.city ?? "未設定"}</p>
    </div>
  );
}

もしここで user.name と書いてしまうと、データが届く一瞬のあいだにエラーが起きて画面が真っ白になってしまいます。user?.name と書いておくだけで、通信中の安全な表示を簡単に実現できます。

注意点:なんでも ?. にすれば良いわけではない

便利なオプショナルチェーンですが、「必ず存在すべきデータ」にまで無闇に ?. を付けるのはおすすめしません。

もしバグやデータの不備で本来あるはずの値が欠けていた場合、?. を付けているとエラーが出ずに undefined のまま処理が進んでしまい、「なぜか画面に何も表示されないけどエラーも出ない」と原因究明が難しくなることがあるためです。

  • 外部APIのレスポンスや、未入力の可能性がある項目 → ?. を使う
  • 必ず存在することが保証されている項目 → 通常の . を使う

という基準で使い分けるのがおすすめです。

まとめ

オプショナルチェーン(?.)を使うと、深い階層のオブジェクトや外部から取得した不確かなデータから、エラーを恐れずに安全に値を取り出すことができます。

  • 昔:user && user.address && user.address.city や in 演算子でチェック
  • 今:user?.address?.city

Null合体演算子(??)と組み合わせれば、Reactでのデータ表示や条件分岐のコードも短く読みやすくなります。モダンJavaScriptの基本である変数宣言(let, const)の記事とあわせて読むと、ES2015以降の書き方の全体像がつかめます。

コメント

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