Восстановление JSON

Похожие

Что такое восстановление JSON (JSON Repair)?

Варианты использования

• Очистка вывода AI/LLM: преобразование в один клик JSON с обёрткой Markdown, пояснительным текстом и висячими запятыми от ChatGPT/Claude в стандартный JSON
• Отладка и устранение неполадок API: быстрое дополнение скобок и строк при обрезанных ответах API из-за проблем шлюза или сети для определения исходной структуры данных
• Объектные литералы JavaScript, скопированные из консоли: единое исправление одинарных кавычек, висячих запятых и ключей без кавычек
• Очистка конфигурационных файлов: удаление комментариев из JSON5/JSONC для получения стандартного JSON, готового к единообразной передаче в downstream-сервисы
• Восстановление данных из логов и буфера обмена: быстрая стандартизация фрагментов JSON, содержащих комментарии, специальные пробелы или обрезку
• Предварительная обработка при миграции данных: добавление шага восстановления в конвейер миграции данных для предотвращения блокировки всего пакета ETL из-за нескольких невалидных JSON

Как использовать

1. Вставьте JSON с ошибками, обёрткой Markdown или обрезанный JSON в левое поле ввода, или нажмите «Пример» для загрузки типичного повреждённого JSON, или загрузите файл .json/.txt
2. Инструмент автоматически обнаружит и исправит распространённые синтаксические проблемы; в правой области вывода отобразится отформатированный стандартный JSON и количество исправленных проблем каждого типа
3. Если остались красные сообщения об ошибках, вы можете вручную отредактировать ввод и повторно запустить восстановление (Mac: ⌘+Shift+R, Windows: Ctrl+Shift+R)
4. Убедившись в правильности структуры, нажмите «Копировать», чтобы поместить восстановленный результат в буфер обмена, или «Скачать», чтобы сохранить как repaired.json для дальнейшего форматирования, валидации и т.д.

Функции

• Охватывает 7 распространённых типов синтаксических ошибок: висячие запятые, одинарные кавычки, ключи без кавычек, незакрытые строки, комментарии, пропущенные скобки, обёртки Markdown-блоков кода
• Оптимизированная очистка вывода ИИ: автоматическое удаление обёрток ```json и пояснительного текста вне блоков кода, распознавание типичного вывода ChatGPT, Claude, Gemini и других LLM
• Совместимость с JSON5/JSONC: парсинг расширенного синтаксиса, включая комментарии, нестрогие кавычки и специальные пробелы (например, невидимые символы Unicode)
• Интеллектуальное дополнение обрезанного JSON: обработка обрезанных ответов API и отсутствующих закрывающих скобок путём автоматического добавления недостающих скобок и кавычек
• Визуализация проблем восстановления: автоматический подсчёт и отображение количества исправленных проблем каждого типа для удобного аудита и ручной проверки
• Локальная обработка для конфиденциальности: разбор, восстановление и форматирование выполняются полностью в браузере, входные данные не отправляются на сервер
• Бесшовная передача в форматирование: восстановленный стандартный JSON можно одним кликом передать в форматировщик JSON, валидатор Schema или генератор кода
• Загрузка файлов и примеров: поддержка загрузки файлов .json/.txt или загрузки образца по клику для быстрой проверки результатов восстановления

Примеры кода

// npm install jsonrepair
import { jsonrepair } from 'jsonrepair';

const broken = `{
  name: 'Alice',
  age: 30,
  tags: ['dev', 'writer',], // trailing comma + comment
}`;

try {
  const fixed = jsonrepair(broken);
  const obj = JSON.parse(fixed);
  console.log(obj);
  // => { name: 'Alice', age: 30, tags: ['dev', 'writer'] }
} catch (err) {
  console.error('Still unrepairable:', err.message);
}

# pip install jsonrepair
from jsonrepair import jsonrepair
import json

broken = '''{
  name: "Alice",
  age: 30,
  tags: ["dev", "writer",], // trailing comma + comment
}'''

fixed = jsonrepair(broken)
obj = json.loads(fixed)
print(obj)
# => {'name': 'Alice', 'age': 30, 'tags': ['dev', 'writer']}

# Удаление висячих запятых из объектов/массивов (экстренный вариант; НЕ обрабатывает комментарии / одинарные кавычки)
# Для сложных сценариев используйте специализированную библиотеку, например jsonrepair
sed -E 's/,([ \t]*[}\]])/\1/g' broken.json > clean.json

# Проверка восстановленного результата
jq . clean.json >/dev/null && echo 'JSON is valid'

Часто задаваемые вопросы

Устранение неполадок

Глоссарий

JSON

JavaScript Object Notation, лёгкий формат обмена данными на основе пар ключ-значение, определённый в RFC 8259. Фактический стандарт для REST API, файлов конфигурации и логов.

RFC 8259

Официальная спецификация JSON, выпущенная IETF, определяющая строгий синтаксис допустимого JSON — все ключи должны быть в двойных кавычках, только ограниченный набор символов в строках требует экранирования, комментарии и висячие запятые не допускаются.

JSON.parse

Строгий JSON-парсер, встроенный в JavaScript и современные браузеры, следующий RFC 8259. При любой синтаксической ошибке выбрасывает SyntaxError и не может выполнять толерантное восстановление.

JSON5

Расширенный синтаксис JSON (нестандартный), допускающий ключи без кавычек, строки в одинарных кавычках, комментарии (// и /* */), висячие запятые, шестнадцатеричные числа и т.д. Удобнее для ручного написания, но несовместим с JSON.parse.

JSONC

JSON with Comments, общее название, используемое редакторами вроде VS Code для JSON-файлов конфигурации с комментариями (например, tsconfig.json). Фактически распространённый псевдоним JSON5.

Trailing Comma / Висячая запятая

Лишняя запятая после последнего элемента объекта или массива. Допускается в JavaScript, но запрещена стандартом JSON — самая распространённая синтаксическая ошибка в выводе LLM и копировании из console.log().

Блок кода Markdown

Фрагмент кода, обёрнутый в три обратные кавычки (```). LLM часто автоматически оборачивают вывод JSON в ```json ... ```; прямая вставка в JSON.parse() приведёт к ошибке.

Tolerant Parser / Толерантный парсер

Парсер, способный пытаться восстановиться и продолжить разбор при обнаружении синтаксических ошибок. Ядро инструмента восстановления JSON, в отличие от строгого JSON.parse.

SyntaxError

Исключение синтаксической ошибки, выбрасываемое JavaScript. Любой строгий JSON-парсер выбрасывает его при получении ввода, не соответствующего RFC 8259.

Canonical JSON / Канонический JSON

JSON, заново сгенерированный через parse + stringify, со стабильным порядком ключей, без лишних пробелов и 100% совместимостью со стандартными парсерами. Конечный формат вывода инструмента восстановления JSON.

Распространённые типы ошибок JSON и примеры восстановления

Восстановление JSON vs Форматирование JSON vs Валидация JSON Schema

Authoritative References

• IETFОфициальная спецификация JSON (RFC 8259)
• MDNJSON.parse - Документация MDN Web
• JSON5JSON5 - Неофициальная спецификация расширенного синтаксиса
• GitHubjsonrepair (josdejong) - Эталонная реализация для браузера и Node