読み方のヒント

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

第2節 スキーマで検証する

2.2 safeParse で確かめる

スキーマの safeParse で、データを確かめます。

const ProductsSchema = z.array(ProductSchema);

const data: unknown = await response.json();
const result = ProductsSchema.safeParse(data);

if (!result.success) {
  console.error(result.error.issues);
  throw new Error("商品のデータの形が正しくありません");
}

const products = result.data;
// products は Product[]
結果持っているもの
success: true確かめた値 data
success: falseまちがいの一覧 error.issues

safeParse は、例外を投げずに結果を返します。parse を使うと、確かめに失敗したときに例外を投げます。

price が文字列の "220" で届いた場合、issues には次のような情報が入ります。

[
  {
    "code": "invalid_type",
    "expected": "number",
    "path": [1, "price"],
    "message": "Invalid input: expected number, received string"
  }
]

path は、どこがまちがっているかを表します。この例では、「2つ目の商品の price」です。手で書いた型ガードでは、ここまで細かい情報を返すのは手間がかかります。

解答の例

const ReservationItemSchema = z.object({ productId: z.string(), quantity: z.number().int().min(1).max(10) }); と書き、type ReservationItem = z.infer<typeof ReservationItemSchema>; で型を作ります。

7 / 16