JSON форматтер: красивый, минимизированный и действительно

Pretty-print: для людей и пул-реквестов

Отступ JSON доступен для просмотра JSON. Два пробела являются соглашением в большинстве баз кода JavaScript и соответствуют значению по умолчанию в `JSON.stringify(value, null, 2)`; четыре пробела подходят редакторам, настроенным таким образом. Выбор форматирования имеет меньшее значение, чем согласованность, поскольку смешанные отступы превращают каждый последующий разброс в шум. Если ваш JSON сгенерирован, установите отступ в генераторе один раз и позвольте форматтеру применить его локально для вставленных полезных данных.

Минимизировать: для полезной нагрузки в сети

Пробелы в JSON не являются обязательными, поэтому их удаление позволит сэкономить. В ответе API размером 200 КБ разница обычно составляет 15–30 процентов байтов, что имеет значение, когда бюджетом является мобильное соединение или заголовок кэша, который вы пытаетесь соблюдать. Минимизация также является правильным шагом перед сохранением полезных данных в столбце базы данных или встраиванием их в URL — просто минимизируйте на этапе сборки, а не вручную, поскольку минимизация вручную JSON — это то место, где отладка заканчивается.

Валидация: ошибки, с которыми вы действительно столкнетесь

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

• Завершающие запятые — `{"a": 1,}` является допустимым JavaScript и недопустимым JSON.
• Одинарные кавычки или ключи без кавычек — `{a: 'b'}` должно стать `{"a": "b"}`.
• Комментарии — `// note` и `/* note */` вообще не место в JSON.
• Неэкранированные управляющие символы — буквальные символы новой строки внутри строки должны быть `\n`.
• Объединенные объекты — два объекта верхнего уровня, расположенные рядом, обычно из файла журнала, по одному документу JSON в каждой строке.

Форматировщик должен указать вам строку, столбец и показать отрывок. Один только «Неожиданный токен» заставляет вас прокручивать; «строка 84, столбец 17 — запятая перед }» — это исправление.

Зачем проверять перед отладкой

Когда интеграция терпит неудачу, инстинктивно хочется проверить код. Чаще всего сама полезная нагрузка имеет неверный формат: шаблон выдал случайную запятую, конвейер журнала обрезал строку или копипаста из документа ввела смарт-кавычки. Запуск форматтера JSON сначала за секунды отделяет «данные неверны» от «неправильный код», а точный номер строки обычно указывает прямо на шаблон, который ее создал.

Большие файлы и конфиденциальность

Ответы API и экспорт базы данных часто содержат токены, личные поля или данные клиентов. Серверное форматирование JSON означает загрузку этой полезной нагрузки третьей стороне для ее возврата — вопрос защиты данных, не имеющий никаких преимуществ, поскольку форматирование — это тривиальная локальная операция. Средство форматирования YamlBox JSON анализирует данные в браузере без сетевых вызовов, поэтому оно работает в автономном режиме и сохраняет полезные данные на вашем компьютере; на той же странице представлены варианты отступов, сортировка ключей для стабильных различий и живая статистика, такая как глубина и количество ключей.