Деэкранирование JSON

Что такое деэкранирование JSON?

// Escaped input (copied from a log, quotes optional)
User said: \"it works!\"\nSession ended.

// Unescaped output — readable again
User said: "it works!"
Session ended.

// \uXXXX and surrogate pairs decode too
caf\u00e9 \ud83d\ude00  ->  café 😀

// JSON-in-JSON
{\"a\":1}  ->  {"a":1}

Ключевые возможности

Примеры

"User said: \"it works!\"\nSession ended."

{\"event\":\"signup\",\"user\":{\"id\":42}}

caf\u00e9 \ud83d\ude00 r\u00e9sum\u00e9

function greet(name) {\n  return \"Hi \" + name;\n}

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

1. 1

   Вставьте экранированную строку

   Введите или вставьте JSON-экранированную строку — с окружающими двойными кавычками или без них. Декодированный текст появится мгновенно. Нажмите «Загрузить пример», чтобы попробовать образец, например экранированную строку лога или строку, закодированную в \uXXXX.

2. 2

   Прочитайте декодированный вывод

   Escape-последовательности становятся настоящими символами: \n превращается в переводы строк, \" — в кавычки, а \uXXXX — в Unicode. Если ввод некорректен, баннер ошибки объяснит проблему, чтобы вы могли исправить проблемный обратный слэш.

3. 3

   Скопируйте или проверьте результат

   Нажмите «Копировать», чтобы забрать читаемый текст, или отправьте его в Форматтер JSON для проверки. Нажмите «Поменять направление», чтобы заново экранировать на месте и подтвердить, что обратное преобразование совпадает с вашим оригиналом.

Частые ошибки декодирования

value: \q and \x41
// \q and \x hex are not valid JSON escapes -> error

value: \\q and \u0041
// literal backslash doubled; hex written as \u -> decodes

say "hi" there
// interior unescaped " breaks auto-wrapping -> error

say \"hi\" there
// interior quotes escaped -> decodes to: say "hi" there

path: C:\Users\Alice
// \U and \A are invalid escapes -> error

path: C:\\Users\\Alice
// doubled backslashes -> decodes to C:\Users\Alice

Частые сценарии использования

Декодирование структурированных полей логов

Скопируйте поле сообщения, полное \n и \", из строки JSON-лога и деэкранируйте его, чтобы прочитать настоящее многострочное сообщение ровно так, как оно было записано, вместо того чтобы вглядываться в escape-последовательности.

Чтение полезных нагрузок JSON-в-JSON

Превратите внутренний JSON-объект, который хранился как экранированное строковое поле, обратно в настоящий JSON, чтобы прочитать его или вставить в парсер — частое явление в конвертах вебхуков и журналах аудита.

Восстановление Unicode из ASCII-безопасного вывода

Декодируйте насыщенный \uXXXX вывод из устаревшей системы обратно в буквы с диакритикой, символы CJK и эмодзи, восстанавливая читаемую человеком форму данных, которые были принудительно сведены к чистому ASCII.

Разворачивание фрагментов кода

Преобразуйте скрипт или запрос, который был сведён в одну строку JSON (каждый перевод строки как \n), обратно в правильно отформатированный, многострочный, читаемый код.

Отладка дважды закодированных данных

Когда значение выглядит как \\n или \\\", деэкранируйте один раз, чтобы проверить, не было ли оно случайно экранировано дважды выше по конвейеру, затем исправьте производителя — частый баг интеграции.

Изучение сообщений об ошибках API

Многие API возвращают детали ошибок как экранированные строки внутри JSON-конверта. Деэкранируйте сообщение, чтобы прочитать трассировки стека и вложенные нагрузки, которые иначе скрыты за escape-последовательностями.

Технические детали

Алгоритм декодирования

Инструмент парсит ввод как строку JSON: если она уже заключена в двойные кавычки, она декодируется как есть, иначе сырой ввод сначала оборачивается в кавычки, чтобы голое экранированное тело всё равно декодировалось. Каждое распознанное экранирование (\n \r \t \b \f \" \\ \/ \uXXXX) сопоставляется со своим символом; это отражает поведение совместимого парсера JSON, гарантируя, что любая строка, экранированная сериализатором, вернётся к своему точному оригиналу.

Восстановление суррогатных пар

Экранирование \uXXXX даёт одну кодовую единицу UTF-16. Когда за высоким суррогатом (\uD800–\uDBFF) сразу следует низкий суррогат (\uDC00–\uDFFF), оба объединяются в одну кодовую точку выше базовой многоязычной плоскости — так \ud83d\ude00 декодируется в один символ 😀, а не в две сломанные половинки.

Валидация и обработка ошибок

Если ввод содержит недопустимое экранирование (обратный слэш, за которым следует нераспознанный символ, или некорректную последовательность \u) или несбалансированные кавычки, ломающие оборачивание, декодирование завершается чисто и показывается баннер ошибки вместо выдачи испорченного вывода. Корректный ввод всегда даёт точную декодированную строку; некорректный ввод никогда не даёт вводящего в заблуждение частичного результата.

Лучшие практики

Вставляйте с кавычками или без — оба варианта работают

Не тратьте время на обрезку окружающих кавычек. Инструмент декодирует "hello\nworld" и hello\nworld одинаково, поэтому вставляйте то, что скопировали — включая фрагмент, вырванный из середины более крупного документа — и читайте результат.

Деэкранируйте один раз, затем проверьте на двойное кодирование

Если в декодированном выводе всё ещё видны последовательности с обратным слэшем вроде \n, оригинал был дважды экранирован выше по конвейеру. Деэкранируйте второй раз для подтверждения, затем исправьте производителя, чтобы он экранировал только один раз, а не полагался на повторное декодирование.

Проверяйте декодированный JSON

После деэкранирования полезной нагрузки JSON-в-JSON прогоните результат через наш Форматтер JSON, чтобы убедиться, что он корректен, и красиво отформатировать его. Деэкранирование восстанавливает текст; форматтер подтверждает структуру.

Проверяйте обратное преобразование с помощью Swap

Нажмите «Поменять направление», чтобы заново экранировать декодированный текст и проверить, совпадает ли он со строкой, с которой вы начали. Несовпадение указывает на некорректный ввод или неожиданное экранирование, выявляя проблемы с данными до того, как они распространятся.

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