20. リテラル型

リテラル型は、特定の値そのものを型にしたものです。"open" という型には文字列 "open" しか入れられません。リテラル型をユニオンで並べた type Direction = "up" | "down" のような形で使うのが定番です。

実務では「決まった選択肢しか受け付けない」値の表現に使います。注文のステータスやボタンのサイズなど、自由な文字列ではなく候補の中から選ぶ値をリテラル型にすると、打ち間違いがその場でエラーになります。

string で受けると "opne" のようなタイプミスも素通りしてしまいます。「候補が列挙できるならリテラル型のユニオンにする」と覚えておくと、実行時バグを型で潰せます。

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

TypeScript

// "up" と "down" の2つの値だけを受け付ける型
type Direction = "up" | "down";

let moveDirection: Direction = "up";
console.log(moveDirection);

moveDirection = "down";
console.log(moveDirection);
// moveDirection = "side"; // 候補にない文字列はエラー

function step(direction: Direction): number {
  return direction === "up" ? 1 : -1;
}
console.log(step("down"));

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