できない.dev

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

別名: optional chaining / ?. / オプショナルチェイニング / オプショナルチェイン

a?.b のように書き、a が null か undefined なら例外を投げずに undefined を返す JavaScript の演算子。
深いプロパティ参照やメソッド呼び出しを短く安全に書ける。

公開: 更新:

定義

オプショナルチェーン(?.)は、左側の値が null か undefined のときにアクセスを打ち切り、例外の代わりに undefined を返す演算子である。
user?.profile?.name と書けば、途中のどこかが欠けていても TypeError にならない。
関数呼び出しは fn?.()、添字アクセスは obj?.[key] と書く。

詳細

MDN(新しいタブで開く) のとおり、評価は最初に nullish だった箇所で止まり、その右側の式や副作用は実行されない。
既定値を入れたいときは ??(Null 合体演算子)と組み合わせる。
TypeScript では ?. を通した結果の型に undefined が加わる。

const name = user?.profile?.name ?? "名無し";

主要ブラウザでは 2020 年 7 月から使える。
これより古い実行環境に向けて配る場合は、Babel などで変換する必要がある。

よくある誤解

  • 代入には使えない。
    obj?.prop = 1 は構文エラーになり、使えるのは読み取りと呼び出しだけである。
  • 括弧で区切ると、連鎖の保護は守られない。
    (a?.b).c は括弧で連鎖が切れるため、a が null なら .c で例外になる。

関連

型の上で null を除く方法は Object is possibly 'null'、DOM 参照で使う例は useRef の current が null で扱っている。