Konwerter JSON na schemat Zod

Czym jest schemat Zod?

Przykłady

{"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>;

Jak przekonwertować JSON na Zod

1. 1

   Wklej swój JSON

   Wstaw obiekt JSON, tablicę lub odpowiedź API do pola wejściowego. Konwersja zaczyna się natychmiast.

2. 2

   Dostrój wynik

   Zmień nazwę schematu głównego i przełączaj linię importu, typ z.infer lub słowo kluczowe export, aby dopasować się do stylu swojego projektu.

3. 3

   Skopiuj lub pobierz

   Przejmij wygenerowany schemat Zod jednym kliknięciem i wklej go prosto do swojej warstwy walidacji.

Common Use Cases

Walidacja odpowiedzi API

Zamień przykładową odpowiedź REST lub GraphQL w schemat Zod i parsuj ją na granicy pobierania, aby nieprawidłowe dane szybko zawiodły z czytelnym błędem, zamiast przeciekać przez aplikację.

Bezpieczne typowo formularze i dane wejściowe

Wygeneruj schemat dla danych z formularza lub zapytania i wykorzystaj ponownie typ z.infer w interfejsie i obsłudze zdarzeń, aby uzyskać pełne bezpieczeństwo typów.

Schematy tRPC i narzędzi AI

Zainicjuj schematy wejścia i wyjścia dla procedur tRPC lub narzędzi AI ze strukturyzowanym wyjściem na podstawie przykładowego ładunku, zamiast pisać je ręcznie.

Jak działa konwersja

Wnioskowanie strukturalne

Każdy obiekt staje się nazwanym schematem; identyczne kształty deklaruje się raz i wykorzystuje ponownie. Tablice obiektów są scalane klucz po kluczu, a klucze nieobecne w niektórych elementach stają się .optional().

Poprawne mapowanie typów

Liczby całkowite są mapowane na z.number().int(), a dziesiętne na z.number(). Ciągi, wartości logiczne i null są mapowane na z.string(), z.boolean() i z.null(); tablica mieszanych typów prostych staje się z.union().

Typy TypeScript w komplecie

Alias typu z.infer jest emitowany dla schematu głównego, więc schemat pozostaje jedynym źródłem prawdy, a twoje typy nigdy nie rozjeżdżają się z walidacją.

100% po stronie klienta

Parsowanie i generowanie działają w przeglądarce bez wywołań sieciowych, więc twoje dane pozostają prywatne.

Wskazówki dla czystych schematów Zod

Nazwij swój schemat główny

Ustaw sensowną nazwę główną, np. User lub ApiResponse, zamiast domyślnego Root, aby uzyskać czytelny, samodokumentujący się kod.

Doprecyzuj z.unknown() i unie

Puste lub mieszane tablice dają z.unknown() lub szerokie z.union(). Wklej bogatszą, reprezentatywną próbkę, aby narzędzie wywnioskowało precyzyjne typy, a następnie zawęź to, co pozostaje niejednoznaczne.

Waliduj na granicy

Wywołuj safeParse() tam, gdzie wchodzą niezaufane dane — odpowiedzi API, dane z formularzy, webhooki — aby złe dane zostały przechwycone, zanim dotrą do logiki aplikacji.

Najczęściej zadawane pytania