Escape Stringhe JSON

Cos'è l'escape delle stringhe JSON?

L'escape delle stringhe JSON è il processo di conversione dei caratteri speciali all'interno di una stringa in sequenze di escape che i parser JSON possono leggere senza rompere la struttura. La specifica JSON (ECMA-404 / RFC 8259) richiede che determinati caratteri all'interno dei valori stringa siano preceduti da un backslash. Senza un escape corretto, un doppio apice o un'andata a capo letterale all'interno di una stringa terminerebbe la stringa prematuramente e produrrebbe un errore di parsing.

Ogni stringa JSON è delimitata da doppi apici. Quando la stringa stessa contiene un doppio apice, un backslash o un carattere di controllo (da U+0000 a U+001F), il carattere deve essere sostituito dalla sua sequenza di escape. Ad esempio, un'andata a capo letterale diventa \n, una tabulazione diventa \t e un doppio apice diventa \". Qualsiasi punto di codice Unicode può essere rappresentato anche come \uXXXX, dove XXXX è il valore esadecimale a quattro cifre.

L'unescape (l'operazione inversa) converte quelle sequenze backslash nei caratteri originali. Usalo quando ricevi un payload JSON in cui i valori stringa sono doppiamente sottoposti a escape, o quando hai bisogno di estrarre testo grezzo da una voce di log JSON per visualizzarla in un'interfaccia o in un terminale. Le pipeline di aggregazione dei log si imbattono continuamente in questo problema: quando un messaggio codificato in JSON è memorizzato come valore stringa all'interno di un altro documento JSON, ogni backslash nella stringa interna arriva raddoppiato.

Perché usare uno strumento di escape JSON?

Aggiungere o rimuovere backslash manualmente è tedioso e soggetto a errori, specialmente con testo su più righe, percorsi di file o frammenti di codice incorporati. Uno strumento dedicato intercetta i casi limite che la modifica manuale lascia sfuggire.

Casi d'uso dell'escape stringhe JSON

Riferimento delle sequenze di escape JSON

La specifica JSON definisce esattamente due escape obbligatori (doppio apice e backslash) e sei sequenze di escape brevi per i caratteri di controllo più comuni. Tutti gli altri caratteri di controllo (da U+0000 a U+001F) devono usare la forma \uXXXX. I caratteri sopra U+FFFF (come gli emoji) possono essere rappresentati come coppia surrogata UTF-16: \uD83D\uDE00.

Escape JSON vs. codifica JSON

Gli sviluppatori a volte confondono l'escape di una stringa con la codifica di un documento JSON completo.

Esempi di codice

Ogni linguaggio principale dispone di funzioni integrate per questo. Esempi in JavaScript, Python, Go e 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"

Domande frequenti