JSON String Escape

Що таке екранування JSON-рядків?

Екранування JSON-рядків — це процес перетворення спеціальних символів у рядку на послідовності екранування, які JSON-парсер зможе прочитати без порушення структури. Специфікація JSON (ECMA-404 / RFC 8259) вимагає, щоб певні символи всередині значень рядків передувалися зворотною скісною рискою. Без належного екранування буквальна подвійна лапка або новий рядок всередині рядка передчасно завершили б його та спричинили б помилку розбору.

Кожен JSON-рядок обмежується подвійними лапками. Коли сам рядок містить подвійну лапку, зворотну скісну риску або керуючий символ (від U+0000 до U+001F), символ необхідно замінити відповідною послідовністю екранування. Наприклад, буквальний новий рядок стає \n, табуляція — \t, а подвійна лапка — \". Будь-яку кодову точку Unicode також можна представити як \uXXXX, де XXXX — чотиризначне шістнадцяткове значення.

Розекранування (зворотна операція) перетворює ці послідовності зі зворотною скісною рискою назад на вихідні символи. Використовуйте його, коли отримуєте JSON-payload, у якому рядкові значення подвійно екрановані, або коли потрібно витягти сирий текст із запису JSON-журналу для відображення в UI або терміналі. Конвеєри агрегації журналів стикаються з цим постійно: коли JSON-закодоване повідомлення зберігається як рядкове значення в іншому JSON-документі, кожна зворотна скісна риска у внутрішньому рядку надходить подвоєною.

Навіщо використовувати інструмент JSON-екранування?

Додавання або видалення зворотних скісних рисок вручну — трудомістке і схильне до помилок заняття, особливо при роботі з багаторядковим текстом, шляхами до файлів або вбудованими фрагментами коду. Спеціалізований інструмент екранування виявляє граничні випадки, які пропускає ручне редагування.

Сценарії використання JSON-екранування

Довідник послідовностей екранування JSON

Специфікація JSON визначає рівно два обов'язкові екранування (подвійна лапка та зворотна скісна риска) і шість коротких послідовностей для поширених керуючих символів. Усі інші керуючі символи (від U+0000 до U+001F) повинні використовувати форму \uXXXX. Символи вище U+FFFF (наприклад, емодзі) можна представити у вигляді сурогатної пари UTF-16: \uD83D\uDE00.

Екранування JSON-рядків vs. JSON-кодування

Розробники іноді плутають екранування рядка з кодуванням повного JSON-документа.

Приклади коду

У кожній популярній мові є вбудовані функції для цього. Приклади на JavaScript, Python, Go та jq:

// JSON.stringify escapes a value and wraps it in quotes
JSON.stringify('Line 1\nLine 2')       // → '"Line 1\\nLine 2"'

// To get just the inner escaped string (no surrounding quotes):
const escaped = JSON.stringify('She said "hello"').slice(1, -1)
// → 'She said \\"hello\\"'

// Parsing reverses the escaping
JSON.parse('"tabs\\tand\\nnewlines"')  // → 'tabs\tand\nnewlines'

// Handling Unicode: emoji in JSON
JSON.stringify('Price: 5\u20ac')       // → '"Price: 5\u20ac"' (raw euro sign)

import json

# json.dumps escapes and quotes a string
json.dumps('Line 1\nLine 2')           # → '"Line 1\\nLine 2"'

# Ensure ASCII: replace non-ASCII with \uXXXX sequences
json.dumps('Caf\u00e9', ensure_ascii=True)   # → '"Caf\\u00e9"'

# Keep UTF-8 characters as-is (default in Python 3)
json.dumps('Caf\u00e9', ensure_ascii=False)  # → '"Caf\u00e9"'

# Unescape by round-tripping through json.loads
json.loads('"She said \\"hello\\""')      # → 'She said "hello"'

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// json.Marshal escapes a Go string for JSON
	raw := "Line 1\nLine 2\tindented"
	b, _ := json.Marshal(raw)
	fmt.Println(string(b))
	// → "Line 1\nLine 2\tindented"

	// Unescape with json.Unmarshal
	var out string
	json.Unmarshal([]byte(`"She said \"hello\""`), &out)
	fmt.Println(out)
	// → She said "hello"
}

# Escape a raw string into a JSON-safe value
echo 'Line 1
Line 2	with tab' | jq -Rs '.'
# → "Line 1\nLine 2\twith tab\n"

# Unescape a JSON string back to raw text
echo '"She said \"hello\""' | jq -r '.'
# → She said "hello"

Поширені запитання