JSON в TypeScript
Генерируйте интерфейсы и типы TypeScript из JSON — со вложенными типами, необязательными полями и объединениями.
100% конфиденциально: всё работает в вашем браузере, ничего не загружается на сервер.
Как преобразовать JSON в TypeScript
Без регистрации и установки — работает прямо в браузере.
- Шаг 1:Вставьте характерный пример JSON (ответ API, конфигурационный файл или фикстуру) или нажмите «Загрузить пример».
- Шаг 2:Задайте имя корневого типа и выберите interface или type, а также параметры export, readonly и unknown.
- Шаг 3:Скопируйте сгенерированные определения в проект или скачайте их как файл .ts.
Вопросы о конвертации JSON в TypeScript
Как сгенерировать интерфейсы TypeScript из JSON?
Вставьте JSON в поле ввода, и инструмент сразу создаст для него интерфейсы TypeScript. Объект верхнего уровня получит выбранное вами корневое имя, а каждый вложенный объект — собственный интерфейс.
Как определяются необязательные свойства?
Если массив содержит несколько объектов, генератор сравнивает их. Свойство, отсутствующее хотя бы в одном элементе, помечается как необязательное с помощью ?, а свойство со значениями разных типов получает тип-объединение.
Что использовать: interface или type?
Оба описывают форму объекта. Интерфейсы можно расширять и объединять, что удобно для публичных API и библиотек; псевдонимы type умеют выражать объединения и mapped-типы. Выбирайте по соглашениям вашего проекта — инструмент поддерживает оба варианта.
Почему пустой массив превращается в unknown[]?
Пустой массив ничего не говорит о своих элементах. unknown[] сохраняет типобезопасность в строгом режиме и заставляет явно уточнить тип; отключите опцию, если предпочитаете any[].
Отправляется ли мой JSON на сервер?
Нет. Генерация типов выполняется полностью в браузере, поэтому приватные ответы API и внутренние данные не покидают ваше устройство.
Похожие Инструменты
Автоматическая генерация типов TypeScript из JSON
Писать интерфейсы TypeScript вручную для каждого ответа API долго и чревато ошибками, особенно если в данных есть вложенные объекты и массивы. Этот бесплатный конвертер JSON в TypeScript анализирует пример вашего JSON и за секунду генерирует точные определения типов: каждый вложенный объект становится отдельным именованным интерфейсом, массивы — типизированными списками, а примитивы — string, number, boolean или null. Имена формируются из ключей в стиле PascalCase, а типы элементов массивов приводятся к единственному числу: addresses превращается в Address, categories — в Category.
Если массив содержит объекты с разными ключами, генератор объединяет их в один интерфейс и помечает свойства, отсутствующие в части элементов, как необязательные, а значения разных типов превращаются в объединения вроде string | null. Можно выбрать объявления interface или type, добавить ключевое слово export, сделать все свойства readonly и использовать unknown вместо any для пустых массивов, чтобы не нарушать строгий режим. Всё работает в браузере, поэтому внутренние ответы API не покидают ваш компьютер: вставьте JSON, скопируйте результат в проект и сразу получите автодополнение и типобезопасность.