Échappement JSON

Qu'est-ce que l'échappement de chaînes JSON ?

L'échappement de chaînes JSON est le processus de conversion des caractères spéciaux à l'intérieur d'une chaîne en séquences d'échappement que les parseurs JSON peuvent lire sans rompre la structure. La spécification JSON (ECMA-404 / RFC 8259) exige que certains caractères à l'intérieur des valeurs de type chaîne soient précédés d'un backslash. Sans échappement correct, un guillemet double ou un saut de ligne littéral à l'intérieur d'une chaîne terminerait la chaîne prématurément et produirait une erreur d'analyse.

Toute chaîne JSON est délimitée par des guillemets doubles. Lorsque la chaîne elle-même contient un guillemet double, un backslash ou un caractère de contrôle (U+0000 à U+001F), ce caractère doit être remplacé par sa séquence d'échappement. Par exemple, un saut de ligne littéral devient \n, une tabulation devient \t, et un guillemet double devient \". Tout point de code Unicode peut également être représenté sous la forme \uXXXX, où XXXX est la valeur hexadécimale à quatre chiffres.

Le déséchappement (l'opération inverse) reconvertit ces séquences à backslash en caractères d'origine. Utilisez-le lorsque vous recevez un payload JSON dont les valeurs de type chaîne sont doublement échappées, ou lorsque vous devez extraire du texte brut d'une entrée de journal JSON pour l'afficher dans une interface ou un terminal. Les pipelines d'agrégation de logs rencontrent constamment ce cas : lorsqu'un message encodé en JSON est stocké comme valeur de type chaîne à l'intérieur d'un autre document JSON, chaque backslash de la chaîne intérieure arrive doublé.

Pourquoi utiliser un outil d'échappement JSON ?

Ajouter ou supprimer des backslashes manuellement est fastidieux et source d'erreurs, surtout avec du texte multiligne, des chemins de fichiers ou des extraits de code imbriqués. Un outil dédié gère les cas limites que l'édition manuelle laisse passer.

Cas d'utilisation de l'échappement JSON

Référence des séquences d'échappement JSON

La spécification JSON définit exactement deux échappements obligatoires (guillemet double et backslash) et six séquences courtes pour les caractères de contrôle courants. Tous les autres caractères de contrôle (U+0000 à U+001F) doivent utiliser la forme \uXXXX. Les caractères au-delà de U+FFFF (comme les emoji) peuvent être représentés sous forme de paire de substitution UTF-16 : \uD83D\uDE00.

Échappement JSON vs encodage JSON

Les développeurs confondent parfois l'échappement d'une chaîne avec l'encodage d'un document JSON complet.

Exemples de code

Chaque langage majeur dispose de fonctions intégrées pour cela. Exemples en JavaScript, Python, Go et 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"

Questions fréquemment posées