Урок
Как да форматирате JSON онлайн
Суровият JSON от отговор на API или конфигурационен файл често е минифициран в един дълъг ред. Четенето, дебъгването или редактирането му в това състояние е мъчително. Това ръководство показва как да подредите JSON с правилна отстъпка с три щраквания, да го валидирате за синтактични грешки и да го минифицирате обратно, когато е нужно, като всичко работи в браузъра ви, без данните да напускат раздела.
Стъпка по стъпка
- Отворете инструмента за форматиране на JSON и поставете своя JSON в левия панел. Можете да поставите директно от клипборда (Ctrl+V), от отговор на curl в командния ред или от който и да е текстов редактор. Входът приема всеки размер в рамките на ограничението на инструмента.
- Изберете режима. Форматиране добавя отстъпка (2 или 4 интервала, по ваш избор); Валидиране само проверява синтаксиса, без да променя JSON; Минифициране премахва всички празни знаци, за да създаде възможно най-малкия изход. За повечето случаи Форматиране е това, което искате.
- Натиснете Изпълни. Форматираният изход се появява в десния панел. Копирайте го с бутона Копиране и го поставете обратно в редактора или конфигурационния файл. Инструментът показва броя редове и броя символи, за да можете да проверите размера на изхода с един поглед.
Четене на съобщенията за грешка
Когато вашият JSON има синтактична грешка, инструментът за форматиране показва грешката с позиция (ред и колона), сочеща точния символ, който е счупил разбора. Чести виновници: завършваща запетая след последния елемент в масив или обект (валидна в JavaScript, но не и в JSON), липсваща или излишна затваряща скоба, ключ, който не е обграден с двойни кавички, или неекраниран специален символ вътре в низ. Поправете отбелязаната позиция и изпълнете отново.
JSON, YAML и CSV: кога да използвате кое
JSON е стандартът за отговори на API и конфигурационни файлове, които трябва да се консумират от код. YAML е предпочитан за конфигурации, редактирани от хора (по-малко пунктуация, поддържа коментари). CSV е най-подходящ за таблични данни, използвани от електронни таблици. Конверторът на данни на този сайт ви позволява да преобразувате между тези три формата на една стъпка: поставете JSON, натиснете Конвертиране, получете YAML или CSV. Минифицираният JSON е полезен и когато трябва да вградите данни в параметър на URL заявка или в HTTP хедър с ограничение на размера.
Инструментите, използвани в това ръководство
Често задавани въпроси
Изпраща ли се моят JSON до сървър?
Не. Инструментът за форматиране работи изцяло в браузъра ви. Вашият JSON се разбира с вградения JSON.parse на браузъра и изходът се изгражда в паметта: нищо не пътува по мрежата. Това има значение, когато JSON съдържа API ключове, токени, вътрешни данни или лична информация, което е често срещано в работните процеси за дебъгване на API.
Какъв е максималният размер, който мога да поставя?
Инструментът за форматиране приема JSON до 5 MB. Над това разборът в основната нишка би замразил раздела на браузъра без обратна връзка. За по-големи JSON файлове използвайте специализиран настолен инструмент като jq в командния ред (jq . file.json), който се справя със стотици мегабайта без проблем.