Про цей інструмент
Форматування JSON (яке часто називають красивим друком або оформленням) використовує компактний JSON і додає пробіли — розриви рядків, відступи, послідовні інтервали — щоб зробити структуру видимою для читачів. Компактний JSON є правильним форматом для передачі: він мінімізує кількість байтів по дроту та пам’яті. Відформатований JSON — правильний формат для перевірки: ієрархія з відступами відкриває вкладену структуру з першого погляду, робить відмінності значущими та дозволяє розробникам знаходити певні поля, не аналізуючи документ подумки.
Цей засіб форматування аналізує вхідні дані як JSON, щоб підтвердити їх дійсність, а потім повторно надсилає їх із відповідним відступом. Недійсний вхід створює помилку, яка вказує на синтаксичну проблему. Дійсні введені дані переформатуються незалежно від того, наскільки компактним чи брудним було джерело. За замовчуванням відступ становить два пробіли, що відповідає найпоширенішій угоді JavaScript.
Форматувальник також пропонує мініфікацію (інверсну операцію), яка видаляє всі непотрібні пробіли для створення найменшого дійсного JSON. Мінімізований випуск корисний для передачі виробництва; форматований вихід корисний для розробки та налагодження.
Навіщо форматувати JSON
Читання глибоко вкладеного JSON без відступу по суті неможливо — структура технічно присутня, але невидима. Навіть помірно складний JSON отримує величезну користь від форматування. Рецензентам коду, налагоджувачам API та всім, хто намагається зрозуміти корисне навантаження даних, потрібен формат JSON, щоб побачити, що там насправді.
Форматування також виявляє помилки. Якщо JSON не вдається проаналізувати під час форматування, у повідомленні про помилку вказується точна позиція синтаксичної проблеми — часто відсутня кома, ключ без лапок або випадкова кома в кінці, яку система створення не позначила. Форматер — це найпростіший доступний засіб перевірки JSON.
Як використовувати
Вставте JSON, натисніть формат.
- Вставте свій JSON: Вставте необроблений або компактний JSON у область введення. Також працює перетягування файлів .json.
- Виберіть відступ: За замовчуванням 2 пробіли. Використовуйте 4 пробіли для проектів, які дотримуються цієї конвенції, або вкладки, якщо це потрібно для ваших подальших інструментів.
- Формат: Вхідні дані аналізуються за допомогою JSON.parse для підтвердження дійсності, а потім серіалізуються за допомогою JSON.stringify і вибраного відступу. Помилки у введенні створюють повідомлення про помилку аналізу, що визначає місце проблеми.
- Скопіюйте або завантажте: Скопіюйте відформатований JSON у буфер обміну або збережіть як .json. Вихідні дані структурно ідентичні вхідним, але мають постійні пробіли.
Загальні випадки використання
Технічні деталі
Форматувальник використовує JSON.parse та JSON.stringify, ту саму пару, яку постачає кожне середовище виконання JavaScript. Синтаксичний аналіз відповідає RFC 8259 (поточна специфікація JSON), допускаючи суворий JSON, але відхиляючи літерали об’єктів JavaScript, коментарі, кінцеві коми та інші розширення JSON5.
JSON.stringify приймає аргумент відступу: число (пробіли) або рядок (спеціальний символ відступу, наприклад табуляція). Форматувальник відкриває обидва варіанти. Вихідні дані сортуються за вихідним порядком для об’єктів (оскільки ES2015 зберіг порядок вставлення властивостей у всіх основних механізмах).
Граничні випадки: великі числа, що перевищують Number.MAX_SAFE_INTEGER, втрачають точність під час аналізу (відоме обмеження JSON; використовуйте рядкові значення для ідентифікаторів, які перевищують 2^53). Екранування Unicode в рядках зберігається буквально. Кінцеві пробіли видаляються з кожного рядка.
Поширені запитання
- Які типи помилок JSON виявляє цей інструмент?
- Інструмент виявляє відсутні коми, невідповідні дужки/дужки, недійсне екранування рядків, кінцеві коми, рядки в одинарних лапках та інші порушення синтаксису відповідно до специфікації JSON RFC 8259.
- Чи може він обробляти дуже великі файли JSON?
- так Форматер обробляє JSON у вашому браузері за допомогою власного синтаксичного аналізу JavaScript, тому він ефективно обробляє файли розміром до кількох мегабайт. Для надзвичайно великих файлів (50 МБ+) час обробки залежить від вашого пристрою.
- Чи підтримує він JSON з коментарями (JSONC)?
- Стандартний JSON не дозволяє коментарі. Якщо ваші дані містять коментарі, валідатор позначить їх як помилки. Для підтримки JSONC видаліть коментарі перед форматуванням.
- Чи змінить форматування значення моїх даних?
- Ні. Форматування коригує лише пробіли та відступи — ваші типи даних, значення та структура залишаються незмінними.
- Чи підтримуються функції JSON5 (коментарі, кінцеві коми)?
- Ні. Форматер суворо відповідає RFC 8259. Функції JSON5 викликають помилки аналізу. Щоб працювати з JSON5, спочатку перетворіть у стандартний JSON за допомогою аналізатора JSON5.
- Чи мій JSON завантажено на сервер?
- Ні. Розбір і форматування повністю виконуються у вашому браузері за допомогою вбудованих функцій JSON.
- Чи втратить точність великих чисел?
- JavaScript представляє числа як 64-розрядні числа з плаваючою точкою, тому цілі числа вище 2^53 (приблизно 9 квадрильйонів) втрачають точність. Для ідентифікаторів або інших великих цілих значень зберігайте їх як рядки в JSON.
- Чи можу я відсортувати ключі за алфавітом?
- JSON.stringify не сортує ключі. Використовуйте окремий крок сортування (або засіб форматування з підтримкою сортування), щоб упорядкувати ключі за алфавітом перед утворенням рядків.
Related Articles
DeveloperEssential Developer Tools: JSON, Base64, RegEx, and More
A comprehensive overview of the developer utilities every programmer should know, from data format converters to encoding tools.
9 min readDeveloper & SecurityHashing, Encryption, and Encoding Explained: A Developer's Security Guide
Understand the differences between hashing, encryption, and encoding. Learn when to use MD5, SHA-256, Base64, AES, and other cryptographic tools in your applications.
10 min readData & ProductivitySpreadsheet & Data Conversion Guide: Excel, CSV, JSON, and More
Learn how to convert between spreadsheet and data formats like Excel, CSV, JSON, and XML. Practical tips for handling data migration, cleaning, and transformation.
10 min readPrivacy & TechnologyWhy Browser-Based Tools Are the Future: No Installs, No Uploads, No Risk
Discover why browser-based tools are replacing desktop software and cloud uploads. Learn how client-side processing keeps your files private while delivering powerful functionality.
7 min read