Sanyanggae LogoSanyanggae

📱 アプリ開発

TypeScriptの条件付き型とinfer:小さな例で確かめる型変換

条件付き型、ユニオンの分配、テンプレートリテラルを例で確認し、実行時検証との違いを説明します。

사냥개 (Sanyanggae)公開 更新 5分で読めます

韓国語原文を翻訳した記事です。 韓国語原文 · 翻訳確認: AIによる確認

条件付き型、inferと分配、実行時検証を整理した説明用図
SANYANGGAE制作の説明用図:条件付き型・inferと分配・実行時検証。

TypeScriptで似た型宣言が繰り返されると、入力型から結果の型を計算する方法を探したくなります。重要なのは文字数が減ることより、型同士の関係が読む人に明確かどうかです。本稿では架空の配送通知サービスで条件付き型とinferを考え、外部データが実際に正しいかを確認する作業と区別します。

1. 条件付き型は型を入力に取る分岐

公式の条件付き型文書は、extendsの条件で結果の型を選ぶ構文を説明しています。以下は文字列型かに応じて真偽値リテラル型を作ります。実行中に文字列を調べる関数ではありません。

type IsText<T> = T extends string ? true : false;
type NameIsText = IsText<'parcel'>; // true
type CountIsText = IsText<3>;       // false

配送通知を作る関数は文字列の識別子を受け取り、内部処理関数は数値の識別子を受け取るとします。条件付き型を使う前に、二つをなぜ分けるか説明できる必要があります。本当に異なる意味なら別名が役立ち、単なる表記差なら入力形式を統一した方が読みやすいかもしれません。型の技法でデータ設計の曖昧さを隠さないでください。

型を検討するときは、期待する入力と結果を組で書きます。文字列・数値・ユニオン・想定外の入力を小さな例に分けると、複雑な宣言を読む負担が減ります。コメントの結果とエディターが推論する型の一致も確認します。型名が自然でも計算結果が異なる場合があります。

2. ユニオンの分配は配列の意味を変える

型パラメーターがそのまま条件の左側にあると、各ユニオン構成要素に条件が適用される分配が起きます。これを防いでユニオン全体を一つとして扱うには、角括弧で囲む形を比較できます。

type SeparateLists<T> = T extends unknown ? T[] : never;
type Together<T> = [T] extends [unknown] ? T[] : never;
type A = SeparateLists<string | number>; // string[] | number[]
type B = Together<string | number>;      // (string | number)[]
const a: A = ['a', 'b'];
const b: B = ['a', 1];

一つ目は文字列だけの配列、または数値だけの配列です。二つ目は一つの配列に文字列と数値を混ぜられます。配送一覧全体が一種類のコードだけを含むべきか、項目ごとに別の種類を許すかで適切な結果が変わります。画面ではどちらも角括弧が見えても、二つの配列の契約は同じではありません。

実務で問題が起きたら、複雑なユーティリティ型全体を一度に読むより、構成要素を一つずつ入力しましょう。文字列、数値、両者のユニオンを入力した結果を比べます。分配を意図したか分かれば、角括弧を加える理由も説明できます。型の検討記録には最終結果だけでなく、許したい値の例も残すとよいでしょう。

3. inferは構造内の型に名前を付けて取り出す

inferは条件付き型で照合した構造の一部に名前を付けるために使います。次はPromiseを一段階だけ外す小さな型です。

type OneResult<T> = T extends Promise<infer Value> ? Value : T;
type Parcel = OneResult<Promise<{ tracking: string }>>;
type ParcelList = OneResult<Promise<string[]>>;

このコードは非同期処理を実行したり待機したりしません。結果の形をコンパイル段階で表すだけです。関数名をResolvedなどにすると実際の値が到着済みの印象を与え得るため、使う場所の文脈も見ます。実行中の待機は引き続き非同期コードが扱う必要があります。

再帰的に待機した結果の型が必要なら、自作の一段階の例を拡張し続ける前に標準ユーティリティ型Awaitedを確認しましょう。教育用の単純さと共通ツールの要件は異なります。チームで新しいユーティリティを導入するなら、標準型と結果が違う入力と、その違いが必要な理由を文書化するとよいでしょう。

4. テンプレートリテラルでイベント名をつなぐ

テンプレートリテラル型では、文字列リテラルの組み合わせを型で表せます。配送サービスでは、対象領域と操作を組み合わせたイベント名が例になります。

type Scope = 'parcel' | 'address';
type Action = 'created' | 'updated';
type EventName = `${Scope}:${Action}`;
const event: EventName = 'parcel:created';

誤字のある名前をコンパイル段階で発見できますが、組み合わせ可能な全イベントが実際のサービスで有効かは別問題です。例えば住所削除イベントしか対応しない場合、単純な領域と操作の積では規則を正確に表せないかもしれません。許可するイベントとpayloadを明示的に対応させる設計を先に考えましょう。

イベントが増えるほど、読む人が実際の名前を探しやすいかも重要になります。自動合成の規則を何段も重ねる代わりに、外部システムへ送る名前を一つのファイルで確認できるようにする方法もあります。抽象化の前後で、新しいメンバーが誤ったイベントをどう見つけるか比べましょう。型の精巧さと使いやすさは併せて評価すべきです。

5. 外部JSONは実行中に検査する

API応答にUserやParcelという型を付けるだけで、実際の応答がその構造だと保証されるわけではありません。外部値をunknownで受け取り、必要なフィールドを調べる簡単な形を見ます。

function hasTracking(value: unknown): value is { tracking: string } {
  return typeof value === 'object' && value !== null
    && 'tracking' in value && typeof value.tracking === 'string';
}
const incoming: unknown = { tracking: 'DEMO-001' };
if (hasTracking(incoming)) console.log(incoming.tracking);

この検査が確かめるのはtrackingフィールドが文字列かどうかまでです。伝票番号が実在するか、ユーザーにその配送を見る権限があるかまでは確認しません。型の絞り込み、業務規則、権限確認は別々の責任として考える必要があります。公式のNarrowing文書は条件分岐で型情報が絞られる過程を説明しています。

6. 型の道具を選ぶ小さな検討手順

まず許す実際の値を二つ、拒否する値を二つ書きます。次に普通のユニオンと明示的なオブジェクト宣言で意味を表します。繰り返す関係が残るとき条件付き型やinferを使えば、導入理由が明確になります。読む時間が大幅に増えるなら、共通部分だけ抽出し他は普通の型に残す選択もできます。

最後に型検査と実行時検査を別々に実施します。誤ったイベント名をコンパイラーが拒否することと、サーバーがフィールドを省略してもプログラムがエラーを説明することの確認は、互いを補います。小さな例の結果を確認して実際の入力境界につなげてこそ、型変換が安全なアプリ設計に役立ちます。

根拠と参考資料

この記事は公開資料に基づいて説明しています。出典の表示は、掲載機関による監修や認定を意味しません。

運営者紹介と連絡先

同じテーマのほかの記事