JSON String Escape

Wat is JSON string escaping?

JSON string escaping is het proces waarbij speciale tekens in een string worden omgezet naar escape-sequenties die JSON-parsers kunnen lezen zonder de structuur te verstoren. De JSON-specificatie (ECMA-404 / RFC 8259) vereist dat bepaalde tekens binnen stringwaarden worden voorafgegaan door een backslash. Zonder correcte escaping zou een letterlijk aanhalingsteken of een regelafbreking in een string de string vroegtijdig beëindigen en een parseerfout veroorzaken.

Elke JSON-string wordt begrensd door dubbele aanhalingstekens. Wanneer de string zelf een dubbel aanhalingsteken, een backslash of een stuurkarakter (U+0000 t/m U+001F) bevat, moet het teken worden vervangen door de bijbehorende escape-sequentie. Zo wordt een letterlijke regelafbreking \n, een tab \t en een dubbel aanhalingsteken \". Elk Unicode-codepunt kan ook worden weergegeven als \uXXXX, waarbij XXXX de viercijferige hexadecimale waarde is.

Unescaping (de omgekeerde bewerking) zet die backslash-sequenties terug naar de oorspronkelijke tekens. Gebruik dit wanneer je een JSON-payload ontvangt waarbij stringwaarden dubbel zijn geëscaped, of wanneer je ruwe tekst wilt extraheren uit een JSON-logvermelding voor weergave in een UI of terminal. Log-aggregatiepijplijnen lopen hier constant tegenaan: wanneer een JSON-gecodeerd bericht als stringwaarde wordt opgeslagen in een ander JSON-document, komen alle backslashes in de binnenste string verdubbeld aan.

Waarom een JSON escape-tool gebruiken?

Handmatig backslashes toevoegen of verwijderen is omslachtig en foutgevoelig, zeker bij tekst met meerdere regels, bestandspaden of ingesloten codefragmenten. Een aparte escape-tool vangt randgevallen op die handmatige bewerking mist.

Gebruiksscenario's voor JSON string escaping

Referentie voor JSON escape-sequenties

De JSON-specificatie definieert precies twee verplichte escapes (dubbel aanhalingsteken en backslash) en zes korte escape-sequenties voor veelgebruikte stuurkarakters. Alle andere stuurkarakters (U+0000 t/m U+001F) moeten de \uXXXX-notatie gebruiken. Tekens boven U+FFFF (zoals emoji) kunnen worden weergegeven als een UTF-16 surrogaatpaar: \uD83D\uDE00.

JSON escaping versus JSON encoding

Ontwikkelaars verwarren het escapen van een string soms met het encoderen van een volledig JSON-document.

Codevoorbeelden

Elke grote programmeertaal heeft ingebouwde functies hiervoor. Voorbeelden in JavaScript, Python, Go en 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"

Veelgestelde vragen