編集

Zod 4 リリース

Zod 4 が安定版としてリリース。Zod 3 からの設計上の制約を解消し、パフォーマンスと型推論効率が大幅に向上。string/array/object のパースが最大 14 倍高速化し、TypeScript の型インスタンス生成も 100 分の 1 に削減。エラーカスタマイズ API が統一され、discriminatedUnion や literal の強化、refine や overwrite の改善など多くの新機能が追加。

パッケージとしてのzod@4.0.0はリリースされておらず、zod@3.25.0以降からzod/v4をインポートして利用する。

tsx
import { z } from "zod/v4";

z.string().optional();
z.string().or(z.number());
z.object({
  /* ... */
}).extend({ age: z.number() });

出展:Zod 4

#Zod Mini

Zod 4 からツリーシェイク可能な軽量版であるzod/v4-miniも提供される。いくつかのメソッドが利用出来ないことに加えて記法が変わる点には注意が必要。

tsx
import { z } from "zod/v4-mini";

z.optional(z.string());
z.union([z.string(), z.number()]);
z.extend(
  z.object({
    /* ... */
  }),
  { age: z.number() }
);
編集