Перейти к содержанию
Логотип CrateX.app

CrateX.app

JSON в TypeScript

JSON в TypeScript

Преобразует примеры JSON в интерфейсы и псевдонимы типов TypeScript, автоматически объединяет поля массивов объектов, определяет необязательные поля и объединения с null и генерирует подходящие объявления типов для пустых массивов и объектов. Подходит для моделирования ответов API, подготовки типов на фронтенде и упорядочивания структур данных.

JSON в TypeScript

Быстрый старт

1
Вставьте корректный пример JSON в левый редактор.
2
Необязательно: задайте собственное имя корневого типа, например ApiResponse, перед генерацией.
3
Проверьте сгенерированные объявления справа. Корни-объекты становятся интерфейсами, а корни-массивы и примитивные значения — псевдонимами типов.
4
Используйте Копировать или Скачать, чтобы забрать сгенерированный .ts-результат в свой проект.

Частые сценарии

Преобразуйте реальные ответы API в стартовые TypeScript-модели для фронтенд-страниц, SDK-клиентов или интеграционных тестов.

Проверяйте смешанные массивы объектов, чтобы увидеть необязательные поля и объединения типов до фиксации API-контракта.

Преобразуйте тестовые JSON-данные в быстрые определения типов для fixture, историй Storybook или прототипов.

Проверяйте вложенные объявления вроде User и Meta, когда меняется форма backend payload.

Рекомендации по использованию

Используйте репрезентативный пример JSON. Генератор выводит типы только из вставленных значений, поэтому отсутствующие случаи не появятся в результате.
Пустые массивы становятся unknown[], а пустые объекты — interface, расширяющим Record<string, unknown>, пока вы не добавите более содержательный пример.
Вложенные объявления нормализуются по именам свойств, поэтому новый вывод чаще использует имена вроде User или Meta вместо старых форм с префиксом корня.
Генерация работает только с корректным JSON. Сначала исправьте синтаксические ошибки; при сбое парсинга редактор показывает строку и столбец.
Корректные пользовательские имена корня сохраняются как есть; некорректные имена нормализуются в допустимый PascalCase-идентификатор TypeScript.

Ограничения и совместимость

Этот инструмент выводит типы из примеров данных, а не из формальной схемы. Поля, которых нет в вашем примере, он не угадает.
Ввод должен быть строгим JSON. Комментарии, висячие запятые и другой синтаксис, допустимый только в JavaScript, отклоняются.
Сгенерированный результат не содержит инструкций export. Добавьте их вручную, если вашему проекту нужны экспортируемые объявления.
Результат — только статический код TypeScript. Он не создаёт runtime-валидаторы, парсеры или сериализаторы.

Конфиденциальность и безопасность

Вся обработка выполняется в вашем браузере; данные не покидают ваше устройство

Частые вопросы

6

Перейдите к следующему шагу с этими связанными инструментами.