TypeScript null と undefined

TypeScript では、null と undefined は特別な扱いがあります。

有効にするstrictNullChecksした後は、これらの値を明示的に処理する必要があり、より安全なコードを書くのに役立ちます。


SVG 図解:null と undefined の処理 背景 タイトル null と undefined の処理方法 null 「空値」を表す 明示的な宣言が必要 string | null vs undefined 「未定義」を表す オプショナルプロパティは自動的に含まれる name?: string 矢印 安全 処理方法 安全な処理方法 オプショナルチェーン: obj?.prop null 合体: value ?? default 型ガード: if (val !== null) 下半分 処理シナリオ シナリオ1 ユニオン型の宣言 シナリオ2 オプションのパラメータとプロパティ シナリオ3 null 合体演算子 矢印マーク

null と undefined を処理する必要がある理由

JavaScript では null と undefined はよくあるエラーの原因であり、多くのランタイムエラーがこれらに関連しています。

TypeScript の strictNullChecks オプションは、開発者に null の可能性がある値を明示的に処理するよう要求します。

これによりコーディングの作業量は増えますが、null 値によるランタイムエラーを大幅に減らし、コードの信頼性を高めることができます。

概念の説明:null「空値」を表します。つまり、ここには値がありません。undefined「未定義」を表します。つまり、ここにはまだ値が割り当てられていません。


null と undefined の基本

null は「空値」を表し、undefined は「未定義」を表します。両者は TypeScript では独立した型です。

例

// null 型の変数を宣言
// null のみ代入可能
var empty: null = null;

// undefined 型の変数を宣言
// undefined のみ代入可能
var notDefined: undefined = undefined;

console.log("null: " + empty);
console.log("undefined: " + notDefined);

実行結果:

null: null
undefined: undefined

説明:strictNullChecks を有効にしていない場合、これらの型は相互に代入できます。有効にすると、明示的な宣言が必要です。


ユニオン型で null を処理する

strictNullChecks を有効にすると、ユニオン型を使用して null の可能性がある値を明示的に宣言する必要があります。

例

// ユニオン型:string または null を指定可能
// 値が null の可能性があることを明示的に宣言
var name: string | null = "Alice";
name = null;  // 正しい:null を代入できる

// null の可能性がある値にアクセスするには事前のチェックが必要
// 関数の引数は string または null の可能性がある
function getLength(str: string | null): number {
    // 条件を使用して null かどうかをチェック
    if (str === null) {
        return 0;  // null の場合は 0 を返す
    }
    // TypeScript は str が null でないと推論する
    return str.length;
}

console.log("長さ: " + getLength("hello"));
console.log("長さ: " + getLength(null));

実行結果:

长度: 5
长度: 0

ベストプラクティス:型ガード(if チェック)を使用して型を絞り込み、TypeScript に具体的な型を認識させます。


オプションのパラメータとプロパティ

オプションのパラメータとオプションのプロパティは自動的に undefined を含み、null を明示的に宣言する必要はありません。

例

// オプションのパラメータ:? を使用してマーク
// 引数は string または undefined の可能性がある
function greet(name?: string): string {
    // undefined かどうかをチェック
    if (name === undefined) {
        return "Hello, stranger!";
    }
    return "Hello, " + name;
}

console.log(greet("Alice"));
console.log(greet());

// オプションのプロパティ:? を使用してマーク
// age プロパティはオプションで、存在しない可能性がある
interface User {
    name: string;
    age?: number;  // オプションのプロパティ
}

var user: User = { name: "Bob" };
console.log("ユーザー: " + JSON.stringify(user));

実行結果:

Hello, Alice!
Hello, stranger!
ユーザー: {"name":"Bob"}

説明:オプションのパラメータname?: string次と同等string | undefined。


非 null アサーション演算子

使用!コンパイラに値が null または undefined ではないことを伝えます。これは慎重に使用すべきです。

例

function getLength(str: string | null): number {
    // 非 null アサーション:str が null でないことをコンパイラに伝える
    // これは危険な書き方です。str が実際に null の場合、エラーになります
    return str!.length;
}

console.log("長さ: " + getLength("hello"));

警告:非 null アサーションは TypeScript の型チェックを迂回します。値が実際に null の場合、実行時にもエラーになります。使用はできるだけ避けてください。


null合体演算子

使用する??デフォルト値を提供します。値が null または undefined の場合のみデフォルト値を使用します。

例

// 初期値は null
var name: string | null = null;

// ?? 演算子:左側が null/undefined の場合に右側の値を使用
// name が null の場合、"Guest" を使用
var displayName = name ?? "Guest";

console.log("表示名: " + displayName);

// || 演算子との比較(0 と空文字列を falsy とみなす)
var num: number | null = 0;
var result1 = num ?? 100;  // 0(正しい:0 は null/undefined ではない)
var result2 = num || 100;  // 100(誤り:0 が falsy とみなされる)

console.log("?? 結果: " + result1);
console.log("|| 結果: " + result2);

実行結果:

显示名称: Guest
?? 结果: 0
|| 结果: 100

推奨:優先して使用する??ではなく||。なぜなら??null と undefined のみを処理し、0 や空文字列を誤って falsy とみなすことはありません。


オプショナルチェーン

使用する?.存在しない可能性のあるネストされたプロパティに安全にアクセスし、多段ネスト時の null チェックを回避します。

例

// 人物型を定義、アドレスはオプション
interface Person {
    name: string;
    address?: {
        city: string;
    };
}

// アドレスなしの人物オブジェクトを作成
var person: Person = { name: "Alice" };

// オプショナルチェーン:存在しない可能性のあるプロパティに安全にアクセス
// address が存在しない場合、エラーにならず undefined を返す
var city = person.address?.city;

// null 合体演算子と組み合わせる
console.log("都市: " + city);
console.log("都市: " + (person.address?.city ?? "不明"));

実行結果:

都市: undefined
都市: 未知

ベストプラクティス:オプショナルチェーン?.ネストされたオプショナルプロパティを処理する最良の方法であり、??と組み合わせることでデフォルト値のフォールバックを提供できます。


注意事項

  • 厳格モード:strictNullChecks を有効にして、より良い型安全性を得ることを推奨
  • アサーションを避ける:非 null アサーションはできるだけ使用しない!
  • ?? vs ||:優先して使用する??0 と空文字列の誤判定を避ける
  • オプショナルチェーン:ネストされたオプショナルプロパティを処理する場合は使用する?.

ベストプラクティス:型ガード、オプショナルチェーン、null 合体演算子を使用して null と undefined を処理し、コードをより安全で読みやすくします。


まとめ

null と undefined を正しく処理することは、安全な TypeScript コードを書くための鍵です。

  • 厳格モード:strictNullChecks を有効にした後は明示的な処理が必要
  • ユニオン型:使用してstring | null宣言する
  • オプションのパラメータ/プロパティ:undefined を自動的に含む
  • 非 null アサーション:使用する!(慎重に使用)
  • null 合体:使用??デフォルト値を提供
  • オプショナルチェーン:使用?.安全なアクセス

提案:空値の処理を習慣づけ、オプショナルチェーンとNull合体演算子を使用してコードをより堅牢にしましょう。

その他の拡張