محوّل JSON إلى مخطط Zod

ما هو مخطط Zod؟

أمثلة

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

import { z } from "zod";

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  email: z.string(),
  active: z.boolean(),
  roles: z.array(z.string()),
});

export type Root = z.infer<typeof RootSchema>;

{"repo":"zod","owner":{"login":"colinhacks","id":100}}

import { z } from "zod";

export const OwnerSchema = z.object({
  login: z.string(),
  id: z.number().int(),
});

export const RootSchema = z.object({
  repo: z.string(),
  owner: OwnerSchema,
});

export type Root = z.infer<typeof RootSchema>;

{"users":[{"id":1,"nick":"x"},{"id":2}]}

import { z } from "zod";

export const UserSchema = z.object({
  id: z.number().int(),
  nick: z.string().optional(),
});

export const RootSchema = z.object({
  users: z.array(UserSchema),
});

export type Root = z.infer<typeof RootSchema>;

{"items":[{"sku":"A1","discount":0.1},{"sku":"A2","discount":null}]}

import { z } from "zod";

export const ItemSchema = z.object({
  sku: z.string(),
  discount: z.number().nullable(),
});

export const RootSchema = z.object({
  items: z.array(ItemSchema),
});

export type Root = z.infer<typeof RootSchema>;

كيفية تحويل JSON إلى Zod

1. 1

   الصق بيانات JSON

   أدرِج كائن JSON أو مصفوفة أو استجابة API في صندوق الإدخال. يبدأ التحويل فوراً.

2. 2

   اضبط الإخراج

   أعد تسمية المخطط الجذري وبدّل سطر الاستيراد، أو نوع z.infer، أو كلمة export المفتاحية لتطابق نمط مشروعك.

3. 3

   انسخ أو حمّل

   خذ مخطط Zod المُولَّد بنقرة واحدة والصقه مباشرة في طبقة التحقّق لديك.

Common Use Cases

التحقّق من استجابات API

حوّل عيّنة استجابة REST أو GraphQL إلى مخطط Zod وحلّلها عند حدّ الجلب، فتفشل البيانات المشوّهة بسرعة برسالة خطأ واضحة بدلاً من التسرّب عبر تطبيقك.

نماذج ومدخلات مكتوبة الأنواع

ولّد مخططاً لمدخلات النموذج أو الاستعلام وأعد استخدام نوع z.infer عبر واجهتك ومعالِجاتك لأمان الأنواع من طرف إلى طرف.

مخططات tRPC وأدوات الذكاء الاصطناعي

جهّز مخططات الإدخال والإخراج لإجراءات tRPC أو أدوات المخرجات المنظَّمة للذكاء الاصطناعي من حمولة مثال بدلاً من كتابتها يدوياً.

كيف يعمل التحويل

الاستنتاج البنيوي

يصبح كل كائن مخططاً مسمّى؛ وتُصرَّح الأشكال المتطابقة مرة واحدة ويُعاد استخدامها. تُدمج مصفوفات الكائنات مفتاحاً بمفتاح، والمفاتيح الغائبة من بعض العناصر تصبح .optional().

تعيين الأنواع الصحيح

تُعيَّن الأعداد الصحيحة إلى z.number().int() والعشرية إلى z.number(). وتُعيَّن السلاسل والقيم المنطقية والفارغة إلى z.string() وz.boolean() وz.null()؛ وتصبح مصفوفة الأوّليات المختلطة z.union().

أنواع TypeScript مضمّنة

يُصدَر اسم مستعار للنوع z.infer للمخطط الجذري، فيبقى المخطط مصدر الحقيقة الوحيد ولا تنحرف أنواعك عن تحقّقك أبداً.

100% على جانب المتصفح

يجري التحليل والتوليد في متصفّحك دون أي طلبات شبكة، فتبقى بياناتك خاصة.

نصائح لمخططات Zod نظيفة

سمِّ مخططك الجذري

عيّن اسماً جذرياً ذا معنى مثل User أو ApiResponse بدلاً من الافتراضي Root لكود مقروء وموثّق ذاتياً.

نقّح z.unknown() والاتحادات

تنتج المصفوفات الفارغة أو المختلطة z.unknown() أو z.union() واسعاً. الصق عيّنة أغنى وتمثيلية كي تستنتج الأداة أنواعاً دقيقة، ثم شدّد أي شيء يبقى غامضاً.

تحقّق عند الحدود

استدعِ safeParse() حيث تدخل البيانات غير الموثوقة — استجابات API ومدخلات النماذج وwebhooks — كي تُلتقط البيانات السيّئة قبل أن تصل إلى منطق تطبيقك.

الأسئلة الشائعة