Zod

静的型推論を備えた TypeScript ファーストのスキーマ検証
by @colinhacks

ウェブサイト • Discord • 𝕏 • Bluesky

Zod 4 が安定版になりました！リリースノートはこちらで読めます。

Featured sponsor: Jazz

Interested in featuring? Get in touch.

イントロダクション

Zod は TypeScript ファーストの検証ライブラリです。Zod を使用すると、単純な string から複雑なネストされたオブジェクトまで、データを検証するために使用できる スキーマ を定義できます。

import * as z from "zod";
 
const User = z.object({
  name: z.string(),
});
 
// 信頼できないデータ...
const input = { /* stuff */ };
 
// パースされた結果は検証済みで型安全です！
const data = User.parse(input);
 
// なので安心して使えます :)
console.log(data.name);

特徴

外部依存関係ゼロ
Node.js およびすべての最新ブラウザで動作
極小: 2kb コアバンドル (gzipped)
不変 API: メソッドは新しいインスタンスを返す
簡潔なインターフェース
TypeScript およびプレーンな JS で動作
組み込みの JSON Schema 変換
広範なエコシステム

インストール

npm install zod

Zod は jsr.io でも @zod/zod として入手可能です。

Zod は llms.txt ファイルも提供しています。

要件

Zod は TypeScript v5.5 以降に対してテストされています。古いバージョンでも動作する可能性がありますが、公式にはサポートされていません。

`"strict"`

tsconfig.json で strict モードを有効にする必要があります。これはすべての TypeScript プロジェクトのベストプラクティスです。

// tsconfig.json
{
  // ...
  "compilerOptions": {
    // ...
    "strict": true
  }
}

エコシステム

Zod には、ライブラリ、ツール、統合の活発なエコシステムがあります。Zod をサポートするか、Zod 上に構築されているライブラリの完全なリストについては、エコシステムページを参照してください。

また、私が貢献している以下のプロジェクトも紹介しておきます：

tRPC - Zod スキーマをサポートする、エンドツーエンドの型安全 API
React Hook Form - Zod リゾルバを備えたフックベースのフォーム検証
zshy - 元々は Zod の内部ビルドツールとして作成されました。TypeScript ライブラリ用のバンドラーフリー、バッテリー内蔵のビルドツールです。tsc で動作します。