読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
『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