JSON в TypeScript
Преобразуйте пример JSON в читаемый псевдоним типа TypeScript. Проверьте необязательные поля и смешанные массивы, затем скопируйте код или сохраните файл. Результат описывает только структуру примера и не проверяет данные во время выполнения.
Создать тип из JSON
- Вставьте один документ JSON или загрузите пример. Поддерживаются объекты, массивы и примитивные корневые значения в пределах указанных ограничений. Комментарии, завершающие запятые, повторяющиеся декодированные ключи и непарные суррогаты отклоняются.
- Задайте имя корневого типа: заглавная буква ASCII, затем буквы ASCII, цифры или подчёркивания; всего до 64 символов. Выберите отступ в два или четыре пробела и нажмите «Создать тип».
- Проверьте поля и помните, что тип выведен только из примера. Кнопка копирования копирует только код; загрузка сохраняет тот же код UTF-8 в json-types.ts. При изменении ввода прежний результат удаляется.
Как выводится тип по примеру
Примитивные значения становятся типами null, boolean, number или string. Строки, похожие на даты, идентификаторы или числа, остаются строками. Числовые токены классифицируются без преобразования значения; тип number не гарантирует точность чисел JavaScript.
Объекты в одном контексте объединяются. Ключ становится необязательным, если отсутствует хотя бы в одном объекте этой группы. Явный null — это вариант значения, поэтому необязательное поле и поле, допускающее null, различаются. Пустые объекты тоже учитываются.
Массивы рекурсивно объединяют наблюдаемые элементы, а не становятся кортежами фиксированной длины. Пустые массивы используют данные непустых массивов в том же контексте. Если элементов нет, получается unknown[]; разные пути свойств не объединяются.
Результат — один экспортированный псевдоним типа с вложенными типами и ключами в кавычках. Для группы объектов без ключей используется строковая индексная сигнатура со значениями unknown; она не гарантирует пустой объект. Типы enum, даты, UUID и дискриминантные объединения не выводятся.
Обязательные и необязательные поля и null
В первом объекте примера указаны id 1, label Ada и score null; во втором — id 2 и score 4. Поля id и score есть в обоих объектах и остаются обязательными. Поле label встречается один раз и становится необязательным. Тип score объединяет null и number.
Если поле left содержит пустой массив, а right — массив с числом 1, то left получает unknown[], а right — number[]. Если два соответствующих массива items, один пустой и один с числом 1, встречаются в одной группе объектов, оба дают тип number[].
При объединении объектов с kind ok и value и объектов с kind error и message поле kind становится строковым, а value и message — необязательными. Связь между ними теряется, поэтому тип допускает комбинации, которых не было в примере. Для дискриминантного объединения уточните тип вручную.
Ограничения вывода и размера
Один пример не может показать все будущие поля и варианты. Объявления типов проверяются при компиляции; они не проверяют данные во время выполнения и не доказывают корректность ответа API.
Ввод ограничен 256 КиБ UTF-8, глубиной 32 и 20 000 записей. Каждое значение считается одной записью, каждое свойство объекта добавляет ещё две. Вывод ограничен 1 МиБ вместе с форматированием и последним переводом строки. При превышении результат не выдаётся.
Допускается один BOM в начале. Повторяющиеся декодированные ключи и непарные суррогаты отклоняются. Числовой токен ограничен 1024 символами, абсолютное значение показателя степени — 100000. Тип bigint и точность чисел не выводятся.
Инструмент принимает текст JSON и выдаёт псевдоним типа. Он не импортирует файлы или URL, не выполняет данные, не создаёт интерфейсы или код проверки, не выводит JSON Schema и не устанавливает компилятор. Проверьте объявления в своём проекте TypeScript.
Обработка примера и кода
Инструмент не загружает пример на сервер, не сохраняет историю и не создаёт ссылки или телеметрию с JSON, ключами, именами типов или кодом. Копирование и загрузка выполняются по запросу. Это ограниченное описание не распространяется на другие службы сайта, расширения и дальнейшее использование кода.
JSON в TypeScript вопросы
Источники и ссылки
- rfc-editor.orgRFC 8259Синтаксис JSON и совместимость.
- typescriptlang.orgTypeScript: Everyday TypesПсевдонимы, массивы и объединения TypeScript.
- typescriptlang.orgTypeScript: Object TypesСвойства объектов и индексные сигнатуры.
- typescriptlang.orgTypeScript: unknownТип unknown для значений, о которых нет данных.
- typescriptlang.orgTypeScript: Erased TypesОбъявления типов не обеспечивают проверку во время выполнения.
Источники проверены 2026-11-15. Объединение, правила имён и ограничения определены этим инструментом.
Похожие инструменты
JSON в YAML
Преобразуйте JSON в YAML локально, сохраняя запись чисел и строки в кавычках; скопируйте или скачайте результат целиком.
Открыть инструмент — JSON в YAMLYAML в JSON
Преобразуйте один документ YAML в JSON локально, сохраняя точный числовой текст, и скопируйте или скачайте результат.
Открыть инструмент — YAML в JSONФорматирование YAML
Выравнивайте отступы YAML и копируйте проверенный результат с сохранением комментариев и деталей исходного текста.
Открыть инструмент — Форматирование YAMLФорматирование XML
Локально проверяйте корректность XML 1.0 с учётом пространств имён, форматируйте или сжимайте текст и копируйте или скачивайте результат в UTF-8.
Открыть инструмент — Форматирование XMLФорматирование и проверка JSON
Проверяйте синтаксис JSON, форматируйте или минифицируйте локально, копируйте и скачивайте результат с сохранением исходных данных.
Открыть инструмент — Форматирование и проверка JSON