Кавычки и перенос строки в JSON: как экранировать текст

В строке JSON внутреннюю двойную кавычку нужно экранировать обратной косой чертой, а перенос строки записывать специальной последовательностью. Если вставить обычный перенос прямо между кавычками, строгий разбор JSON завершится ошибкой.

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

Кавычки внутри значения

Пусть нужно отправить фразу с названием курса в прямых кавычках. Корректная запись выглядит так:

{ "text": "Запись на курс \"Керамика\" открыта" }

После разбора значение поля содержит обычные двойные кавычки вокруг названия. Обратные косые черты служат обозначением в JSON и не становятся дополнительными буквами сообщения.

Русские кавычки «ёлочки» можно записать в строке непосредственно. Однако замена кавычек не решает все задачи: если исходный текст должен сохраняться точно, меняйте способ сериализации, а не содержимое.

Перенос строки и обратная косая черта

Для текста из двух строк используйте \n:

{ "text": "Первая строка\nВторая строка" }

Для самой обратной косой черты нужно удвоение:

{ "path": "C:\\Temp\\report.txt" }

Запись JSON и значение после разбора выглядят по-разному. Если вы видите \n в исходном документе, это ещё не означает, что пользователь получит две видимые буквы. Смотрите, на каком этапе находится текст: до разбора или после него.

Лучше поручить сборку библиотеке

В JavaScript создайте обычный объект и вызовите сериализацию:

const payload = {
  text: 'Запись на курс "Керамика" открыта\nНачало в субботу',
};
const body = JSON.stringify(payload);

В этом примере строковое значение содержит кавычки и перенос, а JSON.stringify формирует корректное представление для передачи. Ручная склейка строк становится хрупкой, как только в пользовательском вводе появляется неожиданный знак.

Правила строковых значений определены в стандарте JSON, RFC 8259. Не переносите правила кавычек из JavaScript на JSON без проверки: это разные форматы записи.

Как заметить двойное кодирование

Если после одного разбора вы получили строку с текстом JSON вместо ожидаемого объекта, данные могли сериализовать дважды. Проверьте контракт API и тип результата. Не добавляйте второй JSON.parse наугад: иногда API и должен возвращать строку.

Для отладки сравните исходный объект, отправленное тело запроса и результат разбора на принимающей стороне. Уберите из примера секреты и персональные данные. Если ошибка указывает на неожиданную букву или скобку, используйте порядок поиска Unexpected token.