Конвертер JSON у TypeScript

Писати інтерфейси TypeScript вручну для відповіді JSON API — повільно та ненадійно: вкладені об’єкти потребують власного інтерфейсу, масиви — типу елементів, а поле, яке інколи відсутнє, має бути позначене необов’язковим; пропустіть щось із цього — компілятор мовчатиме, поки ваш код відхилятиметься від реальної структури даних.

Цей конвертер зробить це за вас. Вставте будь-який об’єкт або масив JSON, і він рекурсивно обійде його структуру: вкладений об’єкт стане власним іменованим інтерфейсом, масив об’єктів отримає інтерфейс елемента з полями, порівняними для кожного елемента в цьому масиві; поле, наявне лише в деяких із них, позначається знаком «?» у кінці, а поле, яке іноді є null, а іноді — значенням, виводиться як коректне об’єднання string | null, а не лише одне з них.

Перемикач формату змінює лише спосіб відображення тієї самої визначеної структури: блок інтерфейсу, псевдонім типу або схема Zod, побудована з викликів z.object(), z.array() та z.union() з додаванням .optional() та .nullable(), де це потрібно. Zod — це окремий пакет npm (npm install zod); цей інструмент лише створює код схеми, він нічого не встановлює за вас.

Усе працює локально у вашому браузері, щойно ви набираєте або вставляєте текст, без кнопки відправлення та без завантаження — зручно для даних, що містять реальні клієнтські відомості. Щоб працювати з самим текстом JSON, а не з його визначеними типами, скористайтеся форматувальником JSON для гарного вирівнювання або мініфікації та валідатором JSON для виявлення синтаксичної помилки перед конвертацією.