Utilia

JSON форматиране и валидиране

Безплатно форматиране и валидиране на JSON, което подрежда, минимизира и проверява JSON във вашия браузър, със синтактични грешки по ред и колона.

Как да използвате форматирането на JSON

  1. Поставете JSON в полето за вход.
  2. Изберете стил на отстъп: 2 интервала, 4 интервала или табулации. Включете „Подреди ключовете“, ако искате ключовете на обектите по азбучен ред.
  3. Щракнете „Форматирай“, за да подредите JSON, или „Минимизирай“, за да го свиете в един ред.
  4. Ако JSON е невалиден, прочетете съобщението за грешка, което посочва реда и колоната на проблема, поправете го и опитайте отново.
  5. Копирайте резултата и го използвайте в кода си, документацията или API клиента.

Какво прави този инструмент

JSON (JavaScript Object Notation) е най-разпространеният формат за обмен на данни между уеб услуги и за конфигурационни файлове. Суровият JSON от API често е един плътен ред, труден за четене. Този инструмент го прави четим, проверява дали е валиден и може да го свие обратно, когато ви трябва компактна версия.

  • Форматирай: добавя нови редове и последователен отстъп, така че вложеността на обектите и масивите да се следи лесно. Можете да отстъпвате с 2 интервала, 4 интервала или табулации според стила на проекта си.
  • Минимизирай: премахва всички ненужни интервали, за да получите най-малкия валиден JSON, полезен за пакети данни, вграждане в код или намаляване на размера на файла.
  • Валидирай: проверява дали входът е синтактично правилен JSON. Ако не е, инструментът показва синтактичната грешка с реда и колоната ѝ, за да я намерите бързо.
  • Подреди ключовете: подрежда ключовете на всеки обект по азбучен ред. Това прави големите обекти по-лесни за преглеждане и сравняването на два JSON документа един до друг – много по-лесно.

Чести грешки в JSON

Когато валидирането пропадне, причината обикновено е една от тези:

  • Излишни запетаи накрая: {"a": 1,} не е валиден JSON, макар много езици за програмиране да го позволяват.
  • Единични кавички: низовете и ключовете в JSON трябва да са в двойни кавички. {'name': 'Ана'} е невалиден.
  • Ключове без кавички: {name: "Ана"} е валиден JavaScript, но не и валиден JSON.
  • Коментари: стандартният JSON не позволява коментари // или /* */.
  • Липсващи запетаи или скоби: забравена запетая между два елемента или незатворена } или ].
  • Специални стойности: undefined, NaN и Infinity не са част от JSON.

Редът и колоната в съобщението за грешка сочат къде парсерът е забелязал проблема. Истинската грешка понякога е точно преди тази позиция, например липсваща запетая в края на предишния ред.

Безопасно за чувствителни данни

Цялото форматиране, минимизиране и валидиране се случва локално във вашия браузър. JSON никога не се изпраща към сървър. Това е важно, защото JSON често съдържа чувствителна информация: отговори на API с данни на клиенти, токени за достъп, вътрешни конфигурационни файлове или дневници. С този инструмент тези данни остават на вашата машина.

Често задавани въпроси

Изпраща ли се JSON към сървър?

Не. Инструментът работи изцяло във вашия браузър, така че данните ви никога не напускат устройството ви. Можете да го използвате с отговори на API, конфигурационни файлове и други поверителни данни.

Каква е разликата между форматиране и минимизиране?

Форматирането добавя нови редове и отстъп, за да е JSON лесен за четене от хора. Минимизирането премахва всички ненужни интервали, за да е възможно най-компактен за машините. И двете дават едни и същи данни.

Да използвам ли 2 интервала, 4 интервала или табулации?

Това е изцяло въпрос на стил, а данните са идентични и в двата случая. Два интервала са обичайни в JavaScript проекти и документация на API, 4 интервала – в проекти на Python, а табулациите позволяват на всеки читател да избере ширината на показване. Изберете каквото съответства на проекта ви.

Променя ли подреждането на ключовете данните ми?

Не. В JSON редът на ключовете в обект няма значение, така че подреждането им не променя данните. Редът на елементите в масивите никога не се променя.

Защо грешката сочи погрешен ред?

Парсерът съобщава позицията, на която е разбрал, че JSON е невалиден. Ако сте забравили запетая или затваряща кавичка, това често е в началото на следващия ред или стойност. Погледнете и точно преди съобщената позиция.

Може ли да поправи невалиден JSON автоматично?

Не. Инструментът валидира JSON и ви казва точно къде е синтактичната грешка, но не налучква корекции. Поправете съобщената грешка и форматирайте отново.