【TypeScript】リテラル型とは何か？実例でわかりやすく解説（メリット、種類、具体例）

type ButtonStyle = "primary" | "secondary" | "danger";

function createButton(style: ButtonStyle) {
    console.log(`ボタンのスタイルを変更しました: ${style}`);
}

// type SuccessCode は、数値リテラル '200' 以外のいかなる数値も受け付けない
type SuccessCode = 200;

// なお、成功パターンを複数許容する場合はユニオン型を使う
type CommonSuccessCode = 200 | 201 | 204;

interface ApiResponse {
    status: number; // APIからの応答ステータス
    data: unknown;
}

type SuccessCode = 200;

/**
 * 応答ステータスが成功（200）の場合にのみデータを処理する関数。
 * * @param response APIからの応答オブジェクト
 * @param expectedStatus 期待される成功ステータスコード (SuccessCode型)
 */
function processSuccessfulResponse(response: ApiResponse, expectedStatus: SuccessCode): void {
    
    // 応答ステータスが期待される成功コードと一致するかチェック
    if (response.status === expectedStatus) {
        // expectedStatus は型レベルで 200 であることが保証されている

        console.log(`ステータス ${response.status} で成功しました。`);
        //具体的な処理
    } else {
        // 200 以外のステータス（例: 404や500）が来た場合の処理
        console.error(`期待される成功コード ${expectedStatus} ではありませんでした。実際のステータス: ${response.status}`);
    }
}

// --- 使用例 ---

const goodResponse: ApiResponse = { status: 200, data: { user: "Taro" } };
const badResponse: ApiResponse = { status: 404, data: null };

// 呼び出し例１
processSuccessfulResponse(goodResponse, 200); 　// 出力: ステータス 200 で成功しました。

// 呼び出し例2
processSuccessfulResponse(badResponse, 200); 　// 出力: 期待される成功コード 200 ではありませんでした。実際のステータス: 404

// 呼び出し例3 ※許容しない型の場合
// processSuccessfulResponse(goodResponse, 404); // <- エラーになる