27. instanceof による絞り込み

instanceof は「その値が特定のコンストラクタから作られたオブジェクトか」を調べる演算子です。value instanceof Date が真になるブロックの中では、value は Date 型に絞り込まれ、日付のメソッドが安全に使えるようになります。

typeof はプリミティブ型、in はプロパティの有無で絞り込みましたが、Date や Error、配列といった組み込みオブジェクトの判定には instanceof が向いています。日付を Date でも文字列でも受け取れる関数などが実務の定番です。

つまずきポイントは、type で定義したオブジェクトの型には使えないことです。instanceof が見るのは実行時に「何から作られたか」であって、型の名前ではありません。new で作られる組み込みオブジェクトの判定に使う、と覚えましょう。

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

TypeScript

function formatDate(value: Date | string): string {
  if (value instanceof Date) {
    // ここでは value は Date に絞り込まれる
    return value.getFullYear() + "年" + (value.getMonth() + 1) + "月";
  }
  return value; // ここでは string
}

console.log(formatDate(new Date(2026, 5, 12)));
console.log(formatDate("日付未定"));

// 配列の判定にも使える
function countItems(input: string | string[]): number {
  if (input instanceof Array) {
    return input.length;
  }
  return 1;
}
console.log(countItems(["a", "b", "c"]));
console.log(countItems("single"));

サンプルコードで身につける(5本) →

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。

公式ドキュメントで詳しく ↗