Форматувальник і валідатор JSON

Що робить форматувальник і валідатор JSON

JSON — JavaScript Object Notation, стандартизований як RFC 8259 — це універсальна мова веб-API, конфігураційних файлів та обміну даними. Цей інструмент виконує три пов’язані завдання з будь-яким JSON, який ви вставите. Він гарно форматує (pretty-print) його з чистими, послідовними відступами, щоб суцільна стіна тексту перетворилася на читабельне дерево; він мінімізує його, видаляючи кожен зайвий пробіл і перенос рядка, щоб зменшити розмір даних; і він валідує його, одразу повідомляючи, чи документ коректно сформований, а якщо ні — де саме парсер зупинився. Ви звертаєтеся до нього постійно: читаючи мінімізовану відповідь API, упорядковуючи конфігураційний файл, виявляючи зайву кому, яку відхиляє сервіс, або стискаючи тіло запиту перед надсиланням.

JSON оманливо суворий. Уся його система типів невелика — об’єкти (мапи ключ/значення), масиви (впорядковані списки), рядки, числа, літерали true, false і null — а його синтаксичні правила невблаганні. Ключі та рядки мають використовувати подвійні лапки, ніколи одинарні; коментарів немає; і жодна кінцева кома не дозволена після останнього елемента об’єкта чи масиву. Саме ці три правила спричиняють переважну більшість помилок «недійсний JSON».

Як працюють форматування, мінімізація та валідація

Під капотом інструмент розбирає ваш текст за допомогою вбудованого в браузер парсера JSON, що відповідає стандартам, — це той самий рушій, який використовують ваші застосунки, тож те, що проходить тут, проходить і там. Після розбору в структуру в пам’яті форматування повторно серіалізує її з обраним вами відступом — два пробіли, чотири пробіли або табуляція — вкладаючи кожен рівень на крок глибше, щоб форма даних була очевидною з першого погляду. Мінімізація повторно серіалізує ту саму структуру без відступів і без незначущих пробілів, створюючи найкомпактніше дійсне представлення, яке саме й потрібне для зберігання чи передавання. Валідація просто намагається виконати розбір і повідомляє результат: успіх або повідомлення парсера про помилку, яке описує, чого він очікував і приблизно де зупинився.

Оскільки він використовує справжній парсер, а не приблизний текстовий прохід, валідатор виявляє тонкі проблеми, які пропускає око: ключ без лапок, значення в апострофах, відсутню закривну дужку, керуючий символ усередині рядка або ту сумнозвісну кінцеву кому. Коли ви налагоджуєте інтеграцію й не впевнені, чия помилка — вашого JSON чи серверного, форматування відповіді — найшвидший спосіб побачити її справжню структуру, а наша документація API показує точні форми JSON, які очікують і повертають наші ендпоінти, тож ви можете порівняти їх пліч-о-пліч.

Приклади, сценарії використання та підводні камені

Вставте компактну відповідь на кшталт {"user":{"id":7,"tags":["a","b"],"active":true}}, і форматування розгорне її у дерево з відступами, яке справді можна прочитати; мінімізація робить зворотне. Конфігураційний файл, який сервіс постійно відхиляє, після форматування часто виявляє єдину недоречну кому або коментар, що прослизнув за звичкою з JavaScript. Повсякденні застосування включають перевірку payload’ів вебхуків, порівняння двох відповідей API після форматування обох та підготовку мінімального тіла запиту.

• JSON — це не об’єктний літерал JavaScript: жодних коментарів, жодних кінцевих ком, і кожен ключ має бути рядком у подвійних лапках.
• Числа — це числа подвійної точності IEEE-754, тож дуже великі цілі (понад 2^53) можуть непомітно втратити точність — надсилайте їх як рядки, якщо точність важлива.
• Форматування зберігає порядок ключів так, як вони записані; сам JSON визначає об’єкти як невпорядковані, тож не покладайтеся на порядок для коректності.
• Початкова мітка порядку байтів (BOM) або обгортка з пари лапок після копіювання — поширена причина помилки «unexpected token».

Ваша приватність

Увесь розбір, форматування, мінімізація та валідація відбуваються на сто відсотків локально у вашому браузері. Ваш JSON — який може бути відповіддю API, повною персональних полів, токеном доступу чи приватною конфігурацією — ніколи не залишає ваш пристрій, ніколи не надсилається на жоден сервер і ніколи не логується. Нічого не завантажується і нічого не зберігається після того, як ви закриваєте вкладку. Для даних, що часто містять облікові дані та записи клієнтів, виконання роботи на пристрої — єдиний відповідальний дизайн, і саме так побудований цей валідатор.