Робота з JSON-текстом зазвичай зводиться до трьох різних задач: зробити його читабельним, зробити його компактним або перевірити, що він взагалі коректний. Це три окремі операції, хоч їх часто об’єднують в одному інструменті.
Форматування (pretty-print)
Форматування додає відступи, переноси рядків і пробіли навколо розділових знаків, щоб структуру JSON було легко читати оком. Це суто косметична зміна — вона не впливає на дані, лише на візуальне представлення.
Мінімізація (minify)
Мінімізація прибирає всі зайві пробіли, переноси рядків і відступи, залишаючи лише необхідні символи. Це зменшує розмір файлу, що важливо при передачі мережею чи зберіганні великих обсягів даних — сама структура даних при цьому не змінюється.
Валідація
Валідація перевіряє, чи є текст синтаксично коректним JSON. Типові помилки, які вона ловить: зайва кома перед закриваючою дужкою, одинарні лапки замість подвійних, незакавичені ключі об’єкта, коментарі (яких у стандарті JSON немає) чи незакриті дужки. Валідний JSON — необхідна умова для того, щоб форматування чи мінімізація взагалі спрацювали.
Коли що потрібно
- Форматування — при налагодженні API-відповідей чи ручному редагуванні конфігів.
- Мінімізація — перед відправкою даних мережею чи вбудовуванням у продакшн-код.
- Валідація — при діагностиці, чому парсер відмовляється читати JSON-файл.
JSON5 і JSONC — це не той самий JSON
Деякі середовища (наприклад, конфіги VS Code чи TypeScript) приймають трейлінг-коми, коментарі й незакавичені ключі — це розширення JSON5 або JSONC, а не стандартний JSON (RFC 8259). Валідатор, налаштований на строгий JSON, коректно відхилить такий файл, хоча редактор його «розуміє». Якщо потрібно підтримати коментарі, варто явно позначити формат як JSONC, а не сподіватися, що будь-який JSON-парсер його прийме.