import * as z from 'zod';

// primitive values
z.string();
z.number();
z.bigint();
z.boolean();
z.date();

// empty types
z.undefined();
z.null();
z.void();

// catch-all types
z.any();
z.unknown();

リテラル型も定義できるし、ユニオン型も定義できる。

リテラル型とユニオン型

const tuna = z.literal('tuna');
const twelve = z.literal(12);
const tru = z.literal(true);

const all = z.union([ tuna, twelve, tru ]);

ユニオン型扱るのマジで便利✨
TypeScriptの型もついていて、TypeScriptの良さを存分に存分に味わえるな。
class-validator もいいけど、こっちも良い感じだ。

uttk 2021/01/23

Parsing

パースはエラーを投げるやつと投げないヤツの両方があるのね。

パース

// 失敗するとエラーを投げる

const stringSchema = z.string();
stringSchema.parse('fish'); // => returns "fish"
stringSchema.parse(12); // throws Error('Non-string type: number');


// 失敗してもエラーを投げない

stringSchema.safeParse(12);
// => { success: false; error: ZodError }
stringSchema.safeParse('billie');
// => { success: true; data: 'billie' }

どちらもTypeScriptの型推論を上手く機能させれるようにしているので、書いていて楽💺

uttk 2022/03/22に更新

Type guards

~~Type guardsもあるのね。~~

const stringSchema = z.string();
const blob: any = 'Albuquerque';

if (stringSchema.check(blob)) {
  // blob is now of type `string`
  // within this if statement
}

~~という事は、スキーマを細かく作ってやると良い感じに再利用できるし、細かな判定も出来る感じか🧷~~

注意

因みに、.safeParse()については記事で解説しています 👇

Thanks @aiya000

あいや - aiya000 2022/03/22

😇

uttk 2022/03/22

oh... 😇

あいや - aiya000 2022/03/22

ヘルパー関数作ってみました 😇

import { ZodType, ZodTypeDef } from 'zod'

export function isValueOf<T>(x: ZodType<T, ZodTypeDef>, y: unknown): y is T {
  return x.safeParse(y).success
}

export function ensureValueOf<T>(
  x: ZodType<T, ZodTypeDef>,
  y: unknown
): asserts y is T {
  if (!isValueOf(x, y)) {
    throw new Error(`It is not a value of the specified type. value: ${y}`)
  }
}

export function requireValueOf<T>(x: ZodType<T, ZodTypeDef>, y: unknown): T {
  ensureValueOf(x, y)
  return y
}

uttk 2021/01/23

Type inference

生成したスキーマから、型を生成できる。

const A = z.string();
type A = z.infer<typeof A>; // string

const u: A = 12; // TypeError
const u: A = 'asdf'; // compiles

uttk 2021/01/23に更新

( ..)φメモメモ

uttk 2021/01/23

VSCodeの拡張もあるにはあるね。
そのうち、なんか凄いの出そう🙄

uttk 2021/03/07

以下の記事は、Reactで使えるバリデーションライブラリを分かりやすく比較しているので、とても参考になる💪