Конвертер 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
- Вставьте JSON (массив записей точнее выводит optional, чем один объект). Загрузите sample для optional vs nullable.
- Задайте имя корня (User, Order, ApiResponse). interface (по умолчанию) или type alias.
- Читайте отчет inference: число деклараций, optional, nullable и unions. Предупреждения про пустые массивы, пустые объекты, all-null и quoted keys.
- Скопируйте TypeScript или скачайте .ts. Положите в types/ и аннотируйте `fetch` / TanStack Query корневым именем.
- На сервер ничего не уходит. Невалидный 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[].
Похожие инструменты
Минификатор и форматировщик JSON
Бесплатный онлайн-минификатор и форматировщик JSON. Сжимайте JSON для меньших payload или форматируйте (pretty-print) с отступом 2 пробела. Валидация по ходу - загрузка не нужна.
Тестер JSONPath
Тестируйте JSONPath онлайн в браузере. Извлеките поле из JSON, попробуйте пример фильтра и копируйте нормализованные пути - ничего не загружается.
Генератор JSON Schema
Бесплатный генератор JSON Schema в браузере. Вставьте образец JSON, выведите типы и форматы, скопируйте Draft-07 или 2020-12. Ничего не загружается.
Конвертер JSON в CSV
Конвертируйте JSON в CSV и CSV в JSON в браузере. Разворачивайте вложенные объекты, собирайте dotted-ключи обратно, NDJSON, пресет Excel EU, RFC 4180. Ничего не загружается.