OSS探訪

Zod — TypeScriptの型と実行時の入力検証を一つのスキーマから得る

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
43,982
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/19

概要

Zodは、TypeScriptでスキーマを定義し、実行時の値を検証しながら静的な型も推論するライブラリです。API応答、フォーム値、設定値など、外部から入るデータをコード内の型と揃えて扱えます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日:

スキーマから検証済みデータと型を得る

z.objectなどでスキーマを定義し、.parseで実行時データを検証すると、検証済みかつ型付けされた値を取得できます。

出典:[2][3]

非同期検証・変換・JSON Schemaを扱う

非同期refinementではparseAsyncを使え、transformやJSON Schema変換なども組み合わせられます。

出典:[2][3]

外部入力とTypeScript型の境界を明示したい場合に

API、フォーム、環境変数、設定ファイルなど、実行時に信頼できない値が入る箇所へ型安全な境界を置きたい開発に向きます。

出典:[2]

型定義だけでなく実行コストと変換挙動も確認する

大きなスキーマや高頻度の検証では実行コストを測定してください。AOT compileは高速化手段ですがnew Functionを使うため、CSP等で禁止される環境では適用できません。

出典:[2]

参考にした公式資料

  1. [1]colinhacks/zod repository(2026-09-21)
  2. [2]Zod README(2026-09-21)
  3. [3]Zod documentation(2026-09-21)
  4. [4]zod package(2026-09-21)
  5. [5]Zod MIT license(2026-09-21)
編集部からの補足

ZodはTypeScript型だけでは検証できないAPI入力や環境変数などの実行時データを、スキーマで検証するためのライブラリです。現在の`zod`は4.6.5です。READMEにはAOT compile機能もありますが、`new Function`を使うためCSP等の制約がある環境では利用条件を確認してください。

3ステップで試す

  1. 1

    Zodを追加

    公式READMEのInstallation手順でZodをプロジェクトへ追加します。

    npm install zod
  2. 2

    オブジェクトスキーマを定義

    期待する実行時データの構造をTypeScriptコード内で定義します。

    const Player = z.object({ username: z.string(), xp: z.number() })
  3. 3

    parseで入力を検証

    入力を検証し、成功時に型付けされた結果が返る基本動作を確認します。

    Player.parse({ username: "billie", xp: 100 })
公式READMEで確認

成長

成長の推移 · 直近30日

43,982 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
166
Open PR
19

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHub Topics

  • typescript
  • schema-validation
  • type-inference
  • runtime-validation
  • static-types
Stars
43,982
Forks
2,198
Watchers
84
Open Issues
47
Contributors
463
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/19

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。