Экранирование JSON

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

// Input text
She said "hi"
then left.

// Escaped (Wrap on) — identical to JSON.stringify(input)
"She said \"hi\"\nthen left."

// Escaped (Wrap off) — just the body, for hand-built JSON
She said \"hi\"\nthen left.

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

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

Примеры

{"event":"signup","user":{"id":42,"name":"Alice"}}

function greet(name) {
  return `Hello, ${name}!`;
}

She said "hello"	then left.

Price: 9.99€ — café société

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

1. 1

   Вставьте текст или JSON

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

2. 2

   Выберите опции экранирования

   Оставьте «Заключить в кавычки» включённой для полного строкового литерала JSON (как JSON.stringify) или выключите, чтобы получить только экранированное тело. Включите «Экранировать не-ASCII» для чистого ASCII-вывода \uXXXX и «Экранировать прямой слэш» при встраивании JSON в HTML-тег <script>.

3. 3

   Скопируйте экранированную строку

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

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

Input already escaped: line1\nline2
Escaped again -> line1\\nline2  (literal backslash-n)

Raw input: line1
line2
Escaped once -> line1\nline2  (real newline encoded)

{"msg": hello \"world\"}
// Missing quotes around the value -> invalid JSON

{"msg": "hello \"world\""}
// Wrap on supplies the quotes -> valid JSON

café  ->  caf\u00e9   (no downstream need; just noise)

café  ->  café         (valid JSON, readable, smaller)

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

Полезные нагрузки вебхуков JSON-в-JSON

Экранируйте тело запроса, чтобы оно могло храниться как строковое поле внутри конверта вебхука, сообщения Kafka или журнала аудита. Оставьте «Заключить в кавычки» включённым — и вывод готов к присвоению ключу во внешнем документе.

Многострочные фрагменты в конфигурации

Превратите многострочный shell-скрипт, SQL-запрос или фрагмент кода в одно строковое значение JSON. Каждый перевод строки становится \n, поэтому файл JSON-конфигурации остаётся корректным в одну строку.

Ручное создание тел REST-запросов

Экранируйте строку JSON перед вставкой в аргумент curl --data или HTTP-клиент, чтобы кавычки и переводы строк пережили оболочку и канал передачи, не сломав запрос.

Безопасное для логов кодирование строк

Экранируйте пользовательский контент перед записью в структурированную строку лога, предотвращая порчу формата лога или нижестоящего парсера JSON-логов внедрёнными кавычками или переводами строк.

Интеграции с устаревшими ASCII-системами

Создавайте чистый ASCII-вывод \uXXXX для SOAP-шлюзов, заголовков email или старых систем, искажающих UTF-8 при передаче, оставаясь при этом полностью декодируемым любым современным парсером JSON.

Встраивание JSON в HTML

Экранируйте прямые слэши, чтобы блок JSON можно было встроить прямо внутрь тега <script> для страниц с серверным рендерингом, не давая </script> внутри данных закрыть тег раньше времени.

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

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

Инструмент сериализует ваш ввод по строковым правилам спецификации JSON: U+0022 (") → \", U+005C (\) → \\, U+0008 → \b, U+000C → \f, U+000A → \n, U+000D → \r, U+0009 → \t, а любой другой символ ниже U+0020 → \u00XX. С включёнными кавычками окружающие двойные кавычки включаются; с выключенными они убираются. Это в точности совпадает с выводом совместимого сериализатора, гарантируя обратное преобразование без потерь.

Unicode и суррогатные пары

По умолчанию символы выше U+007F выводятся как литеральный UTF-8, что JSON разрешает. С включённой опцией «Экранировать не-ASCII» каждый такой символ преобразуется в \uXXXX по его кодовой единице UTF-16; символы вне базовой многоязычной плоскости (эмодзи, редкие письменности) кодируются как суррогатная пара из двух экранирований \uXXXX — например, 😀 (U+1F600) становится \ud83d\ude00, то же представление, что выдаёт сериализатор JSON.

Прямой слэш и контекст HTML

JSON не требует экранирования /, поэтому по умолчанию он сохраняется. При включённой опции «Экранировать прямой слэш» каждый / становится \/. Единственная практическая причина так делать — встраивание в HTML: внутри тега <script> буквальная подстрока </script> закрывает тег независимо от контекста JSON, поэтому экранирование слэша в <\/script> сохраняет встроенный JSON неповреждённым, оставаясь корректным по спецификации.

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

Держите кавычки включёнными для полных литералов

Когда нужно значение для присвоения в коде или вставки после двоеточия в JSON, держите «Заключить в кавычки» включённым — вывод представляет собой полную, парсируемую строку JSON, идентичную JSON.stringify. Выключайте только тогда, когда вы сами набираете окружающие кавычки.

Оставляйте Unicode-экранирование выключенным, если не требуется

Чистый UTF-8 — корректный JSON и гораздо читаемее. Включайте «Экранировать не-ASCII» только для конкретной нижестоящей системы, неправильно обрабатывающей UTF-8 (устаревший SOAP, некоторые конвейеры логов, исходные файлы только в ASCII). Экранирование всего по умолчанию просто делает вывод более зашумлённым.

Экранируйте слэши только для встраивания в HTML

Экранирование прямого слэша имеет значение ровно в одном месте: JSON, встроенный в HTML-тег <script>. Вне этого контекста оно добавляет мусор без пользы, поэтому оставляйте его выключенным для тел REST, файлов конфигурации и полезных нагрузок сообщений.

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

Перед отправкой экранированных данных в конвейер нажмите «Поменять направление», чтобы деэкранировать их и убедиться, что вы получаете исходный текст обратно. Это ловит случайное двойное экранирование — частый источник появления \\n там, где имелось в виду \n. Обратить в любой момент можно нашим инструментом Деэкранирование JSON.

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