Zenn
🟨

this.player = null!; の意味

に公開
TypeScript
tech

this.player = null!; の意味

1. !（Non-null Assertion Operator）とは？

TypeScriptの!（ノン・ヌル・アサーション演算子）は
「この値は絶対にnullやundefinedじゃないよ」とコンパイラに伝えるための記号です。

2. this.player = null!; の挙動

  • null! は「nullだけど、nullじゃないとみなして！」という意味です。
  • つまり、TypeScriptの型チェックを一時的にごまかして、nullを代入しています。

3. どんなときに使う？

  • クラスのプロパティを「とりあえずnullで初期化したいけど、後で絶対に値を代入する」場合などに使います。
  • 例：
    class Game {
  player!: Player;

  constructor() {
    this.player = null!; // 一旦nullで初期化（型エラーを抑制）
  }
  start() {
    this.player = new Player();
  }
}

4. 注意点

  • 実行時には普通にnullが代入されるので、あとでthis.playerを使う前に必ず値をセットしないとエラーになります。
  • あくまで「TypeScriptの型チェックだけを回避する」ためのものです。

まとめ

  • null!は「nullだけど、型エラーを無視して！」という意味。
  • 型チェックを一時的に回避したいときに使う。
  • 実行時にはnullなので、使う前に必ず値をセットすること！

= null!; は使わない方がいい？

= null!; は「nullを代入するが、TypeScriptの型チェック（null許容でない型への代入エラー）を強制的に回避する」という意味です。
この書き方は、型安全性を下げるため、基本的には推奨されません。

理由と注意点

  • null! は「このnullは絶対に安全だ」とTypeScriptに主張するものですが、実際にはnullが代入されるため、実行時にnull参照エラーが発生するリスクがあります。
  • 型エラーを一時的に消すためだけに使うと、後々バグや予期せぬ挙動の原因になります。
  • nullやundefinedの使い分け自体も議論が多く、明確な意図がない限り、初期値として安易にnullを使うべきではないという意見が多いです。

どうしても使う場合

  • クラスのプロパティを「後で必ず初期化する」ことが保証できる場合のみ、限定的に使うのは許容されます。
  • それでも、できればnullやundefinedを許容する型（例：string | nullやstring | undefined）にして、型安全を維持する方が望ましいです。

まとめ

= null!; は型安全性を損なうため、安易に使わない方がよいです。
どうしても必要な場合を除き、型定義や初期化の設計を見直すことをおすすめします。

Discussion