Zod — это TypeScript библиотека для валидации и создания схем данных, позволяющая определять строгие типы на этапе разработки. Она значительно упрощает управление типами и обеспечивает безопасность данных в приложениях. В отличие от других решений для валидации данных, Zod написан на TypeScript и позволяет использовать строгую типизацию как на этапе компиляции, так и на этапе выполнения.

Для простых структур можно задать валидацию буквально в одной строке:

const userSchema = z.object({
  name: z.string(),
  age: z.number(),
  email: z.string().email()
});

Одним из ключевых преимуществ является автоматическая генерация TypeScript типов из схем Zod. Это избавляет от необходимости дублировать логику валидации и типизацию данных:

const user = userSchema.parse({
  name: "Aleksandr",
  age: 31,
  email: "aleksandr@google.com"
});

type User = z.infer<typeof userSchema>; // { name: string, age: number, email: string }

Zod также поддерживает продвинутые методы валидации: асинхронную валидацию, пользовательские валидаторы и возможность задавать условия на основании других значений в объекте:

const passwordSchema = z.string().min(8).max(20);
const customSchema = z.object({
  password: passwordSchema,
  confirmPassword: z.string().refine(
    (value, context) => value === context.parent.password,
    { message: "Пароли должны совпадать" }
  )
});

Композируемость. В Zod схемы можно легко комбинировать и расширять:

const baseUserSchema = z.object({
  name: z.string(),
  age: z.number().min(18),
});

const adminSchema = baseUserSchema.extend({
  isAdmin: z.boolean(),
});

Теперь, когда мы вспомнили/познакомились с основами работы с Zod, можно перейти к неочевидным и полезным вариантам использования.

🔥 Валидация данных с API. Zod идеально подходит для валидации данных, полученных с внешних API. Это помогает избежать ошибок при работе с неподтвержденными данными, особенно если API меняет свою структуру.

const apiResponseSchema = z.object({
  data: z.array(z.object({
    id: z.number(),
    title: z.string(),
  }))
});

fetch("/api/posts")
  .then(response => response.json())
  .then(data => {
    const result = apiResponseSchema.safeParse(data);
    if (!result.success) {
      console.error("Ошибка. Неподдерживаемый тип response: ", result.error);
    }
  });

🔥 Конфигурации приложений. Zod можно использовать для строгой валидации конфигурационных файлов (например, .env). Это гарантирует корректность настроек на разных окружениях и помогает находить ошибки до запуска приложения:

const configSchema = z.object({
  PORT: z.string().regex(/^\d+$/).transform(Number),
  DATABASE_URL: z.string().url(),
});

const config = configSchema.parse(process.env);

🔥 Валидация сложных форм. Скорее всего, вы это уже использовали, но если для кого то в новинку, то будет крайне полезно. В комбинации с React или другими библиотеками Zod помогает создавать более надежные интерфейсы с минимальными усилиями:

const formDataSchema = z.object({
  fields: z.array(z.object({
    label: z.string(),
    value: z.union([z.string(), z.number()]),
  }))
});

А какие кейсы вы встречали, где можно бы было применить Zod и улучшить приложение?
Буду рад узнать и обсудить другие варианты применения библиотеки.

Больше о фронтенде, технологиях и новостях в мире JS в моемТГК — aleksandr_frontend