JSON String Escape

Was ist JSON-String-Escaping?

JSON-String-Escaping bezeichnet das Umwandeln von Sonderzeichen innerhalb eines Strings in Escape-Sequenzen, die JSON-Parser lesen können, ohne die Struktur zu beschädigen. Die JSON-Spezifikation (ECMA-404 / RFC 8259) schreibt vor, dass bestimmten Zeichen innerhalb von String-Werten ein Backslash vorangestellt wird. Ohne korrektes Escaping würde ein wörtliches doppeltes Anführungszeichen oder ein Zeilenumbruch innerhalb eines Strings den String vorzeitig beenden und einen Parse-Fehler erzeugen.

Jeder JSON-String wird durch doppelte Anführungszeichen begrenzt. Enthält der String selbst ein doppeltes Anführungszeichen, einen Backslash oder ein Steuerzeichen (U+0000 bis U+001F), muss das Zeichen durch seine Escape-Sequenz ersetzt werden. Ein wörtlicher Zeilenumbruch wird beispielsweise zu \n, ein Tabulator zu \t und ein doppeltes Anführungszeichen zu \". Jeder Unicode-Codepunkt kann außerdem als \uXXXX dargestellt werden, wobei XXXX der vierstellige Hexadezimalwert ist.

Unescaping (die umgekehrte Operation) wandelt diese Backslash-Sequenzen wieder in die ursprünglichen Zeichen um. Verwenden Sie es, wenn Sie einen JSON-Payload erhalten, in dem String-Werte doppelt maskiert sind, oder wenn Sie rohen Text aus einem JSON-Log-Eintrag für die Anzeige in einer Oberfläche oder einem Terminal extrahieren müssen. Log-Aggregations-Pipelines treffen dies ständig: Wenn eine JSON-kodierte Nachricht als String-Wert in einem anderen JSON-Dokument gespeichert wird, kommt jeder Backslash im inneren String doppelt an.

Warum ein JSON-Escape-Tool verwenden?

Backslashes manuell hinzuzufügen oder zu entfernen ist mühsam und fehleranfällig — besonders bei mehrzeiligem Text, Dateipfaden oder eingebetteten Code-Snippets. Ein dediziertes Escape-Tool erkennt Sonderfälle, die beim manuellen Bearbeiten übersehen werden.

Anwendungsfälle für JSON-String-Escaping

JSON-Escape-Sequenz-Referenz

Die JSON-Spezifikation definiert genau zwei Pflichtescapes (doppeltes Anführungszeichen und Backslash) sowie sechs kurze Escape-Sequenzen für häufige Steuerzeichen. Alle anderen Steuerzeichen (U+0000 bis U+001F) müssen die Form \uXXXX verwenden. Zeichen oberhalb von U+FFFF (wie Emoji) können als UTF-16-Surrogate-Paar dargestellt werden: \uD83D\uDE00.

JSON-Escaping vs. JSON-Kodierung

Entwickler verwechseln manchmal das Escapen eines Strings mit der Kodierung eines vollständigen JSON-Dokuments.

Code-Beispiele

Jede gängige Programmiersprache verfügt über eingebaute Funktionen dafür. Beispiele in JavaScript, Python, Go und 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"

Häufig gestellte Fragen