Конвертер JSON у Zod — генератор схем

Схеми Zod, згенеровані з JSON

Типи TypeScript зникають під час виконання, тож дані з API, форми чи localStorage безпечні рівно настільки, наскільки безпечний код, що їх перевіряє. Zod закриває цю прогалину: він перевіряє значення за схемою й виводить тип TypeScript із цієї самої схеми. Цей конвертер JSON у Zod пише схему за вас: вставте зразок JSON — і кожен об'єкт стане z.object, примітиви відповідатимуть z.string(), z.number() і z.boolean(), масиви стануть z.array(...), а вкладені об'єкти отримають власні іменовані схеми, які повторно використовуються всюди, де зустрічаються.

Інструмент працює на quicktype, який об'єднує всі елементи кожного масиву перед виведенням типів. Поля, що з'являються лише в деяких елементах, позначаються як optional, а значення, що іноді дорівнюють null, — як nullable, тож схема приймає реальні дані, які ви бачили, а не лише їхній перший елемент.

Схеми та виведені типи разом

За замовчуванням вивід також експортує тип TypeScript для кожної схеми через z.infer, даючи єдине джерело істини для валідації та статичної типізації. Імпортуйте кореневу схему та викличте RootSchema.parse(data), щоб перевірити недовірене значення й отримати типізований результат, або safeParse, коли хочете обробляти помилки без винятків. Позначте Schemas only, якщо воліли б оголошувати типи деінде. Це природний компаньйон до інструмента JSON у TypeScript, коли потрібні гарантії часу виконання, а не лише підказки на етапі компіляції.

Поради для суворіших схем

Генеруйте з репрезентативного зразка з кількома елементами масиву та заповненими необов'язковими полями. Потім доопрацюйте те, чого зразок показати не може: додайте .email(), .url() або .uuid() до рядкових полів, використовуйте z.enum для полів із фіксованим набором значень, обмежуйте числа через .int() або .min() і вирішіть, чи слід видаляти невідомі ключі, чи відхиляти їх через .strict(). Уся генерація відбувається локально, тож ви можете безпечно вставляти production-навантаження.