読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第3節 API の応答を検証する

3.2 読み込みの関数に組みこむ

『TS型設計 ジェネリクス』で作った loadJson に、スキーマを渡します。

const loadJson = async <T>(url: string, schema: z.ZodType<T>): Promise<LoadState<T>> => {
  try {
    const response = await fetch(url);
    if (!response.ok) {
      return { status: "error", message: `読み込みに失敗しました(${response.status})` };
    }
    const result = schema.safeParse(await response.json());
    if (!result.success) {
      console.error(result.error.issues);
      return { status: "error", message: "データの形が正しくありません" };
    }
    return { status: "success", data: result.data };
  } catch {
    return { status: "error", message: "通信できませんでした" };
  }
};

const state = await loadJson("/api/reservations", z.array(ReservationSchema));
// state は LoadState<Reservation[]>

型の引数 T は、渡したスキーマから決まります。呼ぶ側が好きな型を決めることはできず、確かめた結果の型だけが返ります。

失敗の種類画面に出すもの記録するもの
通信できない「通信できませんでした」―
状態コードが 200 番台でない「読み込みに失敗しました」状態コード
形が正しくない「データの形が正しくありません」issues

形が正しくないことは、サーバーの変更などで起きます。利用者には短い案内を出し、細かい情報は開発者が調べられるように記録します。

解答

失敗します。status が "picked_up" の予約には pickedUpAt が必要ですが、ありません。issues の path は [0, "pickedUpAt"] になります。

11 / 16