JSON в YAML — конвертер JSON YAML

Что делает конвертер JSON в YAML

Конвертер JSON в YAML превращает строгий JSON в читаемый YAML на основе отступов и преобразует YAML обратно в отформатированный JSON. В направлении JSON в YAML входные данные разбираются встроенным парсером JSON, а затем сериализуются с помощью js-yaml: объекты становятся вложенными маппингами, массивы — блочными последовательностями, а скалярные значения теряют фигурные скобки и большинство кавычек. В направлении YAML в JSON YAML разбирается, а результат выводится как JSON с отступом в два пробела. Ошибки валидации показываются сразу, что помогает заметить лишние запятые в конце, пропущенные кавычки, несогласованные отступы и случайные табуляции, прежде чем вы скопируете некорректный результат.

Это удобно, когда конфигурацию переносят между системами, предпочитающими разные форматы: превратить компактный блок конфигурации JSON в более удобный файл YAML для CI-конвейера, манифеста Kubernetes или файла настроек статического сайта либо вернуть пример YAML в JSON для API-запроса или фикстуры. И источник, и результат остаются на экране, поэтому небольшие преобразования легко проверить, а конвертация не применяет скрытых значений по умолчанию и не меняет порядок данных сверх того, чего требует сериализатор.

Приватный рабочий процесс в браузере

Вся обработка происходит в вашем браузере с помощью клиентского JavaScript. Инструмент не загружает фрагменты кода, значения конфигурации, идентификаторы, токены или скопированные примеры на сервер и не требует учётной записи. Такая исключительно локальная модель важна для инструментов разработчика, ведь вставляемое содержимое часто напоминает реальные данные приложения: ответы API, манифесты развёртывания, примеры в виде переменных окружения и значения, скопированные из сеансов отладки в продакшене. Локальное преобразование снижает риски и делает работу быстрой, поскольку нет сетевых запросов.

Интерфейс намеренно компактный: вы вставляете входные данные, выбираете направление, проверяете результат, копируете его и возвращаетесь в свой редактор. Результаты всё равно стоит проверять, прежде чем коммитить, публиковать или использовать в производственном процессе. Браузерные инструменты отлично подходят для быстрого просмотра и подготовки, но они не знают всех соглашений проекта, правил классификации данных и специфических требований к валидации вашего приложения.

Практические советы

YAML концептуально является надмножеством JSON, но его практическая модель данных меньше, если придерживаться обычных объектов, массивов, строк, чисел, булевых значений и null — они конвертируются туда и обратно без потерь. Будьте осторожны со значениями, которые YAML может трактовать особым образом: отдельные слова вроде yes, no, on и off могут стать булевыми значениями, а строки без кавычек, похожие на числа или даты, могут изменить тип, поэтому берите их в кавычки, когда важен точный текст. При конвертации конфигурации для продакшена проверяйте готовый файл тем инструментом, который будет его использовать, и удаляйте из входных данных все секреты, прежде чем копировать примеры куда-либо, даже если эта страница выполняет конвертацию локально.