การตรวจสอบขณะทำงานด้วย Zod

ยินดีต้อนรับ

การติดตั้ง Zod

npm install zod

สคีมาพื้นฐาน

import { z } from 'zod';
const UserSchema = z.object({
  id: z.number(),
  name: z.string(),
  email: z.string().email(),
});
type User = z.infer<typeof UserSchema>;

การแยกวิเคราะห์ข้อมูล

const user = UserSchema.parse({ id: 1, name: 'Alice', email: 'a@b.com' });
// user is typed as User

การแยกวิเคราะห์อย่างปลอดภัย

const result = UserSchema.safeParse(unknownData);
if (result.success) {
  console.log(result.data); // User
} else {
  console.log(result.error.issues);
}

สคีมาอาร์เรย์และออบเจ็กต์

const UsersSchema = z.array(UserSchema);
const CreateUserSchema = UserSchema.omit({ id: true });

ค่าที่ไม่บังคับและค่าว่างได้

const Schema = z.object({
  name: z.string(),
  bio: z.string().optional(),   // string | undefined
  avatar: z.string().nullable(), // string | null
});

Enum และ Union

const StatusSchema = z.enum(['active', 'inactive', 'banned']);
const InputSchema = z.string().or(z.number());

การแปลง

const PriceSchema = z.string().transform(s => parseFloat(s));

Zod ในเส้นทาง API

app.post('/users', async (req, res) => {
  const result = CreateUserSchema.safeParse(req.body);
  if (!result.success) return res.status(400).json(result.error);
  const user = await db.create(result.data); // typed!
  res.json(user);
});

ตัวตรวจสอบแบบกำหนดเอง

const PasswordSchema = z.string().min(8).refine(
  s => /[A-Z]/.test(s), { message: 'Need uppercase' }
);

ตรวจสอบสั้น ๆ

สรุปทบทวน