Вставьте JSON в поле, выберите отступ и нажмите кнопку форматирования - получите читаемый вид или сообщение об ошибке с номером строки и символа.
Форматирование и проверка JSON
Как отформатировать и проверить JSON
- Вставьте текст в поле ввода: ответ API, содержимое файла конфигурации, строку из лога.
- Выберите отступ: 2 пробела, 4 пробела или табуляция.
- Нажмите кнопку форматирования. Если JSON корректен, ниже появится красиво оформленный текст, а в статусе - тип значения и число элементов или ключей.
- Для сжатия в одну строку нажмите кнопку "Сжать в строку": пробелы и переводы строк уберутся, данные останутся прежними.
Проверка выполняется встроенным в браузер разбором JSON, данные никуда не отправляются. О самом формате и его типах подробно написано в статье JSON - что это такое.
Что показывают результаты
При успешном разборе статус сообщает, что JSON корректен, и уточняет верхний уровень: для массива указано число элементов, для объекта - число ключей, для простого значения - его тип.
При ошибке выводится текст сообщения браузера и, если движок указал позицию, строка и номер символа. Сообщения зависят от браузера: Chrome и Firefox формулируют их по-разному, но позиция примерно одна и та же. Часто настоящая причина находится чуть раньше указанного места - например, лишняя запятая обнаруживается только на закрывающей скобке.
Частые ошибки JSON
Большинство "неверных" JSON написаны как обычные объекты JavaScript. Строгий формат на несколько вещей не согласен.
| Ошибка | Неправильно | Правильно |
|---|---|---|
| Одинарные кавычки | {'name': 'Ivan'} | {"name": "Ivan"} |
| Ключ без кавычек | {name: "Ivan"} | {"name": "Ivan"} |
| Запятая в конце | {"a": 1, "b": 2,} | {"a": 1, "b": 2} |
| Комментарии | {"a": 1} // тест | комментарии в JSON не допускаются, их удаляют |
| Значения undefined, NaN | {"a": undefined} | {"a": null} |
| Ведущий ноль | {"n": 007} | {"n": 7} или строка "007" |
| Незакрытая скобка | {"a": [1, 2} | {"a": [1, 2]} |
Если данные приходят из внешнего сервиса, посмотрите статью что такое API. Если JSON "почти правильный", но валидатор ругается на самый первый символ, проверьте, нет ли в начале невидимой метки порядка байтов (BOM) или лишнего текста перед скобкой. Такое часто бывает при копировании из файла, сохранённого в Блокноте.
Как работать с JSON в Python
Модуль json входит в стандартную библиотеку. Этот код разбирает строку, меняет значение и выводит красивый результат с русским текстом без экранирования.
import json
raw = '{"name": "Иван", "age": 30, "skills": ["Python", "SQL"]}'
data = json.loads(raw) # строка -> словарь
data["age"] += 1
print(json.dumps(data, ensure_ascii=False, indent=2))
Будет напечатан объект с отступом в 2 пробела, а имя останется кириллицей благодаря ensure_ascii=False. Ошибку разбора ловят через json.JSONDecodeError, у неё есть поля lineno и colno.
import json
try:
json.loads('{"a": 1,}')
except json.JSONDecodeError as e:
print("Ошибка:", e.msg, "строка", e.lineno, "символ", e.colno)
Читать и писать файлы удобнее через json.load(f) и json.dump(data, f), открывая файл с encoding="utf-8". Основы работы с файлами есть в материале про чтение и запись файлов в Python.
Как работать с JSON в JavaScript
В браузере и в Node.js для этого есть глобальный объект JSON. Пример делает то же, что и кнопки инструмента.
const raw = '{"name": "Иван", "age": 30}';
try {
const data = JSON.parse(raw);
console.log(JSON.stringify(data, null, 2)); // с отступом 2
console.log(JSON.stringify(data)); // в одну строку
} catch (e) {
console.error("Не JSON:", e.message);
}
Третий аргумент JSON.stringify задаёт отступ: число пробелов или строку, например "\t". Значения undefined и функции при сериализации отбрасываются, а Date превращается в строку формата ISO.
Для запросов к серверам пригодится знание кодов ответов HTTP: ответ с кодом 200 не гарантирует, что в теле лежит корректный JSON.
Что делать, если JSON не проходит проверку
- Найдите позицию из сообщения и посмотрите на несколько символов до неё.
- Замените все одинарные кавычки на двойные и уберите запятые перед закрывающими скобками.
- Удалите комментарии и значения вроде
undefined. - Если данные пришли из Python через
print(dict), в них будутTrue,Noneи одинарные кавычки. Для JSON нужныtrue,nullиjson.dumps. - Если файл огромный, разбейте его по частям и проверьте каждую отдельно.
Один формат другим не заменить: файлы YAML и JSON выглядят похоже, но YAML допускает комментарии и отступы вместо скобок, поэтому его нельзя вставлять в поле как есть.
