JSON String Escape

Co je escapování JSON řetězců?

Escapování JSON řetězců je proces převodu speciálních znaků uvnitř řetězce na escape sekvence, které JSON parsery dokáží zpracovat bez narušení struktury. Specifikace JSON (ECMA-404 / RFC 8259) vyžaduje, aby určité znaky uvnitř řetězcových hodnot byly uvozeny zpětným lomítkem. Bez správného escapování by literální dvojitá uvozovka nebo znak nového řádku uvnitř řetězce ukončily řetězec předčasně a způsobily chybu při parsování.

Každý JSON řetězec je ohraničen dvojitými uvozovkami. Pokud řetězec sám obsahuje dvojitou uvozovku, zpětné lomítko nebo řídicí znak (U+0000 až U+001F), musí být daný znak nahrazen jeho escape sekvencí. Například literální znak nového řádku se zapíše jako \n, tabulátor jako \t a dvojitá uvozovka jako \". Libovolný Unicode kódový bod lze také zapsat ve formě \uXXXX, kde XXXX je čtyřmístná hexadecimální hodnota.

Unescapování (zpětná operace) převede tyto sekvence se zpětným lomítkem zpět na původní znaky. Použijte ji, když obdržíte JSON payload, kde jsou hodnoty řetězců dvojitě escapovány, nebo když potřebujete extrahovat čistý text z JSON záznamu logu pro zobrazení v UI nebo terminálu. V agregačních pipeline logů se s tím setkáte neustále: pokud je JSON zakódovaná zpráva uložena jako hodnota řetězce uvnitř jiného JSON dokumentu, každé zpětné lomítko ve vnitřním řetězci dorazí zdvojené.

Proč používat nástroj pro escapování JSON?

Ruční přidávání nebo odstraňování zpětných lomítek je únavné a náchylné k chybám, zejména při práci s víceřádkovým textem, cestami k souborům nebo vloženými úryvky kódu. Specializovaný nástroj zachytí okrajové případy, které při ručním editování unikají.

Případy použití escapování JSON řetězců

Přehled JSON escape sekvencí

JSON specifikace definuje přesně dvě povinná escapování (dvojitá uvozovka a zpětné lomítko) a šest krátkých escape sekvencí pro běžné řídicí znaky. Všechny ostatní řídicí znaky (U+0000 až U+001F) musí používat formu \uXXXX. Znaky nad U+FFFF (jako emodži) lze zapsat jako UTF-16 náhradní pár: \uD83D\uDE00.

Escapování JSON vs. kódování JSON

Vývojáři si někdy pletou escapování řetězce s kódováním celého JSON dokumentu.

Příklady kódu

Každý hlavní jazyk má pro tuto operaci vestavěné funkce. Příklady v JavaScriptu, Pythonu, Go a 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"

Často kladené dotazy