Форматування та перевірка JSON

Спробуйте наданий приклад

Завантажте order-options.json — вигадане замовлення з двома товарами та назвами полів англійською. Об'єкт customer об'єднує ім'я та місто; масив items містить CARD-02, а потім BOX-01. Приклад містить текст у лапках, числові кількості й ціни, логічне значення true та null для порожньої примітки до доставки. Поля навмисно не відсортовані, щоб показати дію сортування.

Покрокова інструкція

1. Відкрийте Форматування й перевірка JSON. За допомогою Файл відкрийте наданий order-options.json або вставте його вміст у Ваші дані.
2. Установіть Відступ на 2, щоб використовувати два пробіли на рівень. Для першого запуску залиште Сортувати ключі об’єктів без позначки.
3. Виберіть Обробити дані. Інструмент перевіряє синтаксис JSON перед показом результату. Якщо він повідомить про помилку, знайдіть її за рядком і стовпцем, виправте вхідні дані та спробуйте ще раз.
4. Перегляньте результат. Об'єкт customer і два товари мають бути зрозумілими: по одному полю або елементу списку в рядку. Поки сортування вимкнено, поля зберігають порядок із прикладу.
5. Виберіть Завантажити результат, щоб зберегти formatted.json. Також можна скористатися Копіювати текст, щоб перенести результат до іншого редактора.
6. Відкрийте завантажений файл у текстовому редакторі та порівняйте його з прикладом за перевірками нижче. Потім спробуйте інші варіанти відступів і сортування, знову вибираючи Обробити дані після кожної зміни.

Приклади до та після

Ці короткі приклади показують об'єкт customer з order-options.json як невеликий документ JSON. Порівняйте те саме ім'я й місто до та після кожного налаштування. Необов'язковий довідковий розділ наприкінці містить повне замовлення.

{"customer":{"name":"Zoë","city":"Bergen"}}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "city": "Bergen",
    "name": "Zoë"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{"customer":{"name":"Zoë","city":"Bergen"}}

Вибрати відступи

Зміна вхідних даних або налаштування очищає попередній результат. Знову виберіть Обробити дані, щоб створити результат із новими налаштуваннями. Інструмент щоразу читає поле введення й не підставляє туди попередній результат автоматично.

Сортування ключів об'єктів

Залиште Сортувати ключі об’єктів без позначки, щоб зберегти початковий порядок полів кожного об'єкта. Якщо позначити цей параметр, ключі в усьому документі сортуються за текстовим порядком з урахуванням регістру, зокрема в об'єктах усередині масивів. Самі елементи масивів зберігають початкову послідовність.

1. Залиште Відступ на 2, позначте Сортувати ключі об’єктів і виберіть Обробити дані.
2. Ключі верхнього рівня тепер мають порядок customer, deliveryNote, items, order і paid. Усередині customer поле city стоїть перед name. У кожному товарі price стоїть перед quantity і sku.
3. Масив items і далі містить CARD-02, а потім BOX-01. Сортування ключів не сортує товари за sku чи ціною.

Копіювання, завантаження та новий початок

Перевірити завантажений JSON

• Відкрийте formatted.json у текстовому редакторі. Перевірте, що замовлення має номер ORD-1042, клієнт — Zoë з Bergen і є два товари.
• Перевірте значення та їхні типи: quantity містить числа 2, а потім 1; ціни зберігають 19.50 і 5.00; paid — логічне значення true без лапок; deliveryNote — значення null без лапок. Імена й коди товарів у лапках залишаються рядками.
• Після перевірки Сортувати ключі об’єктів підтвердьте описаний вище порядок полів і те, що CARD-02 і далі стоїть перед BOX-01 у масиві items.
• Спробуйте Мініфікувати і Обробити дані. Вставте результат назад у Ваші дані, установіть Відступ на 2 і знову виберіть Обробити дані. Порівняйте значення й порядок товарів із початковим прикладом: форматування має їх зберігати.

Запитання й усунення несправностей

Чому інструмент повідомляє про некоректний JSON?

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

Чи можна використовувати коментарі або кінцеву кому?

Видаліть коментарі та коми безпосередньо перед закривальною квадратною чи фігурною дужкою. Вони не дозволені в JSON. Форматувальник потребує коректних вхідних даних і не виправляє їх автоматично.

Що означає попередження про повторний ключ?

Повідомлення «Повторні ключі збережено. Деякі програми відкидають повторні ключі.» означає, що ключ трапляється більше одного разу в тому самому об'єкті. Форматувальник зберігає ці записи й попереджає вас. Перегляньте джерело, виберіть потрібне значення та видаліть зайвий запис; інша програма може залишити лише один із них.

Чому файл не відкривається або не обробляється?

Обмеження вхідних даних — 2 MiB, тобто 2 097 152 байти. Локальні текстові файли мають бути в UTF-8. Якщо інструмент повідомляє про надто складні дані, зменште вкладеність або кількість записів. Розділяйте великі дані на менші повні документи JSON, не розрізаючи об'єкт чи масив посередині.

Чому довгі числа змінюються в іншій програмі?

Окремий приклад точності нижче містить 9007199254740993 і 0.10000000000000001. Цей форматувальник точно зберігає текст чисел за будь-якого варіанта відступів і сортування. Відформатуйте exact-numbers.json і порівняйте результат з exact-numbers-formatted.json у текстовому редакторі. Програма, що імпортує результат, усе одно може округлювати числа, тому перевірте підтримку потрібної точності. Код із початковими нулями, як-от 00123, має бути рядком у лапках у JSON.

Чи може форматування відновити вже округлені цифри?

Форматування не може відновити цифри, округлені або видалені до надходження тексту в інструмент. Поверніться до початкового джерела й знову експортуйте повне значення. Якщо це ідентифікатор, а не кількість, використання рядка може допомогти програмам-отримувачам зберегти всі цифри.

Пов’язані інструменти

Джерела