読み方のヒント

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

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

3.1 判別可能なユニオンのスキーマ

予約のスキーマを、状態ごとに書きます。

const ReservationBaseSchema = z.object({
  id: z.string().regex(/^R-\d{4}$/),
  name: z.string().min(1),
  pickupAt: z.string(),
  items: z.array(ReservationItemSchema).min(1),
});

export const ReservationSchema = z.discriminatedUnion("status", [
  ReservationBaseSchema.extend({ status: z.literal("reserved") }),
  ReservationBaseSchema.extend({ status: z.literal("picked_up"), pickedUpAt: z.string() }),
  ReservationBaseSchema.extend({ status: z.literal("cancelled"), cancelledAt: z.string() }),
]);

export type Reservation = z.infer<typeof ReservationSchema>;
書き方意味
z.discriminatedUnion("status", [...])status で見分ける判別可能なユニオン
.extend({ ... })共通のスキーマに項目を足す
z.literal("reserved")この値だけを許す
.regex(/^R-\d{4}$/)「R-」と4けたの数字の形に限る

z.infer で作った Reservation の型は、『TS型設計 判別可能なユニオンで状態を表す』で手で書いた型と同じ形になります。

10 / 16