Форматування JSON

Що таке JSON?

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

JSON підтримує шість типів даних: рядки (у подвійних лапках), числа, булеві значення (true/false), null, об'єкти (пари ключ-значення у фігурних дужках) та масиви (впорядковані списки у квадратних дужках). Його простота та універсальність зробили його домінуючим форматом для вебAPI, конфігураційних файлів і зберігання даних.

Як форматувати JSON

Вставте свій JSON в область введення. Форматер перевіряє синтаксис, виявляє помилки та видає правильно розміщений вивід. Якщо ваш JSON недійсний, точне місце помилки виділяється, щоб ви могли швидко її виправити. Можна перемикатися між красивим (зручним для читання) та мінімізованим (компактним) виводом.

Що робить форматер JSON?

• Перевіряє синтаксис JSON та повідомляє точне місце помилок.
• Розкрашовує вивід за допомогою послідовних відступів та розривів рядків.
• Мінімізує JSON, видаляючи всі зайві пробіли для зменшення розміру файлу.

Поширені помилки JSON

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

Ефективна робота з JSON

При налагодженні відповідей API спочатку форматуйте JSON, щоб зробити структуру видимою. Глибоко вкладені об'єкти набагато легше переглядати з правильними відступами. Для конфігураційних файлів розгляньте можливість використання JSON5 або JSONC (JSON з коментарями), якщо ваші інструменти це підтримують.

Для великих файлів JSON (понад 1 MB) використовуйте потокові аналізатори замість завантаження всього документа в пам'ять. Такі інструменти, як jq (командний рядок) або онлайн-засоби пошуку шляхів JSON, можуть витягувати конкретні значення зі складних структур без переформатування всього документа.

JSON проти інших форматів

Порівняно з XML, JSON більш лаконічний і легший для аналізу. Порівняно з YAML, JSON суворіший і менш схильний до помилок відступів. Порівняно з CSV, JSON природно обробляє вкладені та ієрархічні дані. Кожен формат має свої переваги, але баланс простоти та виразності JSON робить його вибором за замовчуванням для вебAPI.

Чи захищений мій JSON?

Так. Вся обробка відбувається у вашому браузері за допомогою вбудованої функції JavaScript JSON.parse(). Ваші дані ніколи не надсилаються на сервер. Ви можете безпечно форматувати конфіденційні конфігураційні файли, ключі API та особисті дані.

Часті запитання

Який максимальний розмір файлу JSON?

Специфікація JSON не визначає обмеження розміру. Практичні обмеження залежать від аналізатора та доступної пам'яті. Більшість вебAPI обробляють JSON-навантаження до 10–100 MB без проблем. Цей браузерний інструмент добре працює з файлами до кількох мегабайт.

Чи може JSON містити функції або дати?

Ні. JSON підтримує лише рядки, числа, булеві значення, null, об'єкти та масиви. Функції не є дійсними значеннями JSON. Дати мають бути представлені у вигляді рядків (зазвичай у форматі ISO 8601, як-от «2024-01-15T10:30:00Z») і аналізуватися застосунком-приймачем.