Перейти к содержимому
ToolsMinify logo
Инструменты для разработчиков

Конвертер JSON в интерфейсы TypeScript

Сгенерируйте интерфейсы TypeScript из JSON-образца в браузере - без аккаунта, загрузки и codegen CLI.

О Конвертер JSON в интерфейсы TypeScript

Сгенерируйте интерфейсы TypeScript из JSON-образца в браузере - без аккаунта, загрузки и codegen CLI. Вставьте ответ API или лучше массив записей. Вложенные объекты становятся именованными interfaces, массивы типизируются по каждому элементу (не только первому), одинаковые формы дедуплицируются. Walker не схлопывает отсутствующие ключи и JSON null: ключ, отсутствующий в части элементов, optional (`?`); ключ с JSON null - `T | null`. Копируйте в `.ts` или скачайте. Используйте с JSON Minifier, если payload пришел минифицированным, или JSONPath Tester для одного поля.

Как использовать Конвертер JSON в интерфейсы TypeScript

  1. Вставьте JSON (массив записей точнее выводит optional, чем один объект). Загрузите sample для optional vs nullable.
  2. Задайте имя корня (User, Order, ApiResponse). interface (по умолчанию) или type alias.
  3. Читайте отчет inference: число деклараций, optional, nullable и unions. Предупреждения про пустые массивы, пустые объекты, all-null и quoted keys.
  4. Скопируйте TypeScript или скачайте .ts. Положите в types/ и аннотируйте `fetch` / TanStack Query корневым именем.
  5. На сервер ничего не уходит. Невалидный JSON - строка и колонка.

Примеры: Конвертер JSON в интерфейсы TypeScript

Optional из массива записей

[{"sku":"A1","qty":2},{"sku":"B7","qty":1,"gift":true}] дает Order с gift?: boolean. Ключ optional, потому что первый элемент без gift - не из-за null.

Nullable vs optional

Два user: email отсутствует в одной строке, note null в другой дают email?: string и note: string | null. Пропущенные ключи и JSON null раздельны - большинство конвертеров схлопывают.

Вложенные именованные interfaces

{"user":{"address":{"city":"London"}}} выдает Address, User, Root. Вложенные объекты именуются по ключам в PascalCase.

Quoted keys и пустые контейнеры

{"content-type":"application/json","items":[],"meta":{}} экранирует content-type, items как unknown[], meta как Record<string, unknown>. Предупреждения - вставьте более богатый sample.

interface vs type alias

interface для форм API (declaration merging, чуть лучше ошибки). type alias для unions и mapped types. В runtime идентично.

Типичные сценарии

  • Типизация fetch() или axios в React, Vue или Next.js
  • Генерация generics TanStack Query / SWR из реального payload
  • Webhook body (Stripe, GitHub, Slack) в типизированное событие
  • Черновик типов для фикстуры до OpenAPI
  • JSON config blob в TypeScript для редактора

Частые вопросы о Конвертер JSON в интерфейсы TypeScript

Как конвертировать JSON в интерфейс TypeScript?
Вставьте JSON-образец, назовите корень и скопируйте interfaces. В браузере. Вложенные объекты - именованные interfaces, массивы по каждому элементу, пропущенные в массиве ключи - optional с ?.
Чем optional (?) отличается от nullable (| null)?
Optional - ключ отсутствовал в части элементов массива. Nullable - ключ был, значение JSON null. email?: string допускает пропуск. note: string | null требует ключ. Не схлопывается в email?: string | null без обоих случаев в sample.
interface или type alias?
interface для object shapes с расширением между файлами. type alias для unions, intersections и mapped types. Для API-ответа оба подходят; по умолчанию interface как в типичном TypeScript для JSON-моделей.
Почему поле unknown[] или Record<string, unknown>?
Пустые массивы без элементов для анализа - unknown[]. Пустые объекты без ключей - Record<string, unknown>. Вставьте заполненный пример для конкретного типа элемента.
Заменяет ли это quicktype?
Нет. quicktype.io - мультиязычный codegen и runtime validators. Это приватный клиентский JSON to TypeScript interface для вставленного payload - без установки и отчет optional vs JSON null.
Загружается ли JSON?
Нет. Парсинг и inference только в браузере. Безопасно для внутренних API, токенов и PII. DevTools Network: конвертация без запроса.
Можно ли типы из JSON-массива?
Да, и нужно при разных ключах. Массив записей сливается в один interface. Пропущенные ключи становятся optional. Корень Users дает interface User и type Users = User[]. Корень User - типизируйте payload как User[].