JSON String Escape

Vad är JSON string escaping?

JSON string escaping är processen att konvertera specialtecken inuti en sträng till escape-sekvenser som JSON-parsers kan läsa utan att bryta strukturen. JSON-specifikationen (ECMA-404 / RFC 8259) kräver att vissa tecken inuti strängvärden föregås av ett omvänt snedstreck. Utan korrekt escaping skulle ett bokstavligt dubbelt citattecken eller en radbrytning inuti en sträng avsluta strängen i förtid och orsaka ett parsningsfel.

Varje JSON-sträng avgränsas av dubbla citattecken. När strängen själv innehåller ett dubbelt citattecken, ett omvänt snedstreck eller ett kontrolltecken (U+0000 till U+001F), måste tecknet ersättas av dess escape-sekvens. Till exempel blir en bokstavlig radbrytning \n, ett tabbtecken blir \t och ett dubbelt citattecken blir \". Alla Unicode-kodpunkter kan också representeras som \uXXXX, där XXXX är det fyrsiffriga hexadecimala värdet.

Unescaping (den omvända operationen) konverterar dessa omvänt-snedstrecks-sekvenser tillbaka till de ursprungliga tecknen. Använd det när du tar emot en JSON-nyttolast där strängvärden är dubbel-escapade, eller när du behöver extrahera råtext från en JSON-loggpost för visning i ett gränssnitt eller en terminal. Loggaggregationspipelines stöter på detta hela tiden: när ett JSON-kodat meddelande lagras som ett strängvärde inuti ett annat JSON-dokument anländer varje omvänt snedstreck i den inre strängen fördubblat.

Varför använda ett JSON escape-verktyg?

Att manuellt lägga till eller ta bort omvända snedstreck är omständligt och felbenäget, särskilt när man hanterar flerradstext, filsökvägar eller inbäddade kodsnuttar. Ett dedikerat escape-verktyg fångar upp specialfall som manuell redigering missar.

Användningsfall för JSON string escape

Referens för JSON escape-sekvenser

JSON-specifikationen definierar exakt två obligatoriska escapes (dubbelt citattecken och omvänt snedstreck) och sex korta escape-sekvenser för vanliga kontrolltecken. Alla andra kontrolltecken (U+0000 till U+001F) måste använda formen \uXXXX. Tecken ovanför U+FFFF (som emoji) kan representeras som ett UTF-16-surrogat par: \uD83D\uDE00.

JSON escaping vs. JSON-kodning

Utvecklare förväxlar ibland escaping av en sträng med kodning av ett helt JSON-dokument.

Kodexempel

Alla stora programspråk har inbyggda funktioner för detta. Exempel i JavaScript, Python, Go och 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"

Vanliga frågor