Zodスキーマの基礎
プリミティブ、オブジェクト、配列のスキーマを定義します。
「Zodスキーマの基礎」はCoddyKit上の無料TypeScript Academyレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはTypeScript Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 TypeScript Academyコースには全4レッスンが含まれています。
なぜ実行時検証が必要か
TypeScriptの型は実行時には消えてしまいます。API、フォーム、ファイルから取得するデータは、境界を越える時点では型付けされていません。Zodはそのデータを実行時に検証し、型も提供します。
import { z } from "zod";
// Types check at compile time; Zod checks values at runtime.Zodをインポートする
zodパッケージからz名前空間を取り込みます。すべてのスキーマビルダーはz上に用意されています。
import { z } from "zod";
const nameSchema = z.string();
// nameSchema validates that a value is a string.プリミティブスキーマ
Zodにはプリミティブ型用のビルダーがあります。z.string()、z.number()、z.boolean()は、それぞれ1種類の値を検証します。
import { z } from "zod";
const name = z.string();
const age = z.number();
const active = z.boolean();
// Use .parse(value) to validate at runtime.値を検証する
スキーマで.parseを呼び出すと、値を検証できます。値が有効ならその値を返し、無効ならエラーをスローします。
import { z } from "zod";
const schema = z.string();
const result = schema.parse("hello"); // "hello"
const broken = schema.parse(123); // throws ZodErrorオブジェクトスキーマ
z.objectはオブジェクトの形状を記述します。各キーを、その値のスキーマに対応付けます。
import { z } from "zod";
const userSchema = z.object({
name: z.string(),
age: z.number()
});
// userSchema.parse({ name: "Ada", age: 36 }) succeeds.配列スキーマ
z.arrayは、値が配列であり、そのすべての要素が指定したスキーマに一致することを検証します。
import { z } from "zod";
const tags = z.array(z.string());
// tags.parse(["a", "b"]) succeeds; tags.parse([1]) throws.スキーマをネストする
スキーマは組み合わせて使えます。オブジェクトに配列や別のオブジェクトを含めることで、実際のデータ構造をそのまま表現できます。
import { z } from "zod";
const post = z.object({
title: z.string(),
tags: z.array(z.string()),
author: z.object({ name: z.string() })
});
// Validates nested structure in one call.booleanとnumberを組み合わせる
1つのオブジェクトスキーマに複数のフィールド型を組み合わせることで、現実的なレコードをモデル化できます。
import { z } from "zod";
const product = z.object({
name: z.string(),
price: z.number(),
inStock: z.boolean()
});
// product.parse({ name: "Pen", price: 2, inStock: true });スキーマは値として扱える
Zodのスキーマは通常のJavaScriptの値なので、保存したり、受け渡したり、再利用したりできます。コンパイル時にのみ存在するTypeScriptの型とは異なります。
import { z } from "zod";
const emailSchema = z.string();
function check(s: typeof emailSchema, v: unknown) {
return s.parse(v);
}
// You can pass schemas as arguments.未知の入力を検証する
Zodは、解析済みのJSONペイロードのようなunknown型のデータに適しています。値を安全に検証しながら、型を絞り込むこともできるためです。
import { z } from "zod";
const schema = z.object({ id: z.number() });
const raw: unknown = JSON.parse("{ \"id\": 1 }");
const data = schema.parse(raw); // data.id is numberコースの基礎となる要素
z.object、z.string、z.number、z.array、z.booleanを使えば、ほとんどのデータを記述できます。次は、これらのスキーマからTypeScriptの型を推論します。
import { z } from "zod";
const schema = z.object({
name: z.string(),
scores: z.array(z.number())
});
// One schema, ready to validate and to infer a type from.確認問題：Zodの基本
Zodスキーマの基本について理解度を確認します。
まとめ：Zodスキーマの基本
zをインポートし、z.object、z.string、z.number、z.array、z.booleanでスキーマを構築して、.parseで実行時に値を検証する方法を学びました。
import { z } from "zod";
const userSchema = z.object({ name: z.string(), age: z.number() });
// userSchema.parse({ name: "Ada", age: 36 });よくある質問
「Zodスキーマの基礎」レッスンは無料ですか？
はい。「Zodスキーマの基礎」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、TypeScript Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 TypeScript Academyコースには全4レッスンが含まれています。
「Zodスキーマの基礎」で何を学びますか？
プリミティブ、オブジェクト、配列のスキーマを定義します。 ブラウザで直接実行するハンズオンコードでTypeScript Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
TypeScript Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのTypeScript Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「Zodスキーマの基礎」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このTypeScript Academyレッスンでコードを書いて実行できますか？
はい。すべてのTypeScript Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- Zodスキーマの基礎
- スキーマからの型推論
- parseとsafeParse
- スキーマの合成と改良