JSON в YAML

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

Конвертер JSON в YAML превращает JSON-данные в YAML с выбранными отступами. Он помогает подготовить конфигурацию для системы, которая принимает YAML, или представить вложенные данные в более компактной записи.

Как JSON и YAML описывают структуру

JSON использует объекты, массивы, строки, числа, логические значения и null. YAML может выразить эти данные через пары ключ: значение, списки и скаляры. В YAML вложенность обычно определяется отступами, поэтому изменение пробелов вручную способно изменить структуру документа.

Кавычки выбираются при записи результата. Если значение выглядит как специальное слово или число, кавычки помогают сохранить его строковый тип. Они не означают, что исходное значение было изменено на другое.

Отсутствующее поле, null и пустая строка

В объекте JSON поле можно не задать совсем, задать null или присвоить ему пустую строку. Эти состояния различаются. Приложение может трактовать отсутствие как использование значения по умолчанию, null как явное отсутствие значения, а пустую строку как переданный текст нулевой длины.

YAML позволяет записать соответствующие значения разными способами. Поэтому после преобразования проверяйте тип, а не только вид строки: пустое место после двоеточия может обозначать null, а кавычки сохраняют пустую строку. Не удаляйте кавычки только потому, что они кажутся лишними.

Порядок в объекте и порядок в массиве

Имена полей объекта адресуют значения независимо от их оформления. Порядок элементов массива является частью данных: первая стадия конвейера не равна последней. Поэтому сортировка ключей не используется для перестановки содержимого списков.

Это особенно важно для конфигураций с очередностью шагов, правил или обработчиков. После ручной правки YAML отступ может превратить поле объекта в часть соседнего элемента списка. При сомнениях выполните обратное преобразование и сравните структуру, а не только текстовые строки файлов.

Использование отступов и сортировки

Вставьте корректный JSON в «Исходный текст». Установите «Пробелов в отступе» и при необходимости включите «Сортировать ключи». Результат пересчитывается автоматически, скачивание создает файл .yaml.

Сортировка полезна для сопоставления объектов с разным порядком полей. Элементы массивов сохраняют свой порядок: переставлять их было бы изменением данных. Если нужен только просмотр JSON с отступами, достаточно форматирования JSON, без смены формата.

Что проверить в конфигурации

Исходник должен соответствовать JSON: комментарии, одинарные кавычки, лишние запятые, NaN и undefined не допускаются. Конвертер не проверяет схему Kubernetes, CI или другой системы, куда вы перенесете YAML.

Числа разбираются средствами JavaScript. Если числовое значение нельзя прочитать без изменения его десятичного значения, преобразование завершается ошибкой. Длинные идентификаторы передавайте строками, если формат приложения это допускает. Для важных настроек сравните значения с оригиналом перед сохранением файла.