IA sur votre appareil : performant et privé.

Documents

Échapper et déséchapper du JSON : quels caractères échapper et comment réparer une chaîne échappée deux fois

Escape et unescape JSON expliqués : quels caractères JSON impose d'échapper, comment placer du JSON dans une chaîne et comment réparer des guillemets échappés deux fois.

Mis à jour le 8 novembre 202610 min de lecture

Pour échapper un texte en JSON, on place une barre oblique inverse devant chaque guillemet double et devant chaque barre oblique inverse, on remplace les retours à la ligne et les tabulations par \n, \r et \t, puis on entoure le résultat de guillemets doubles. Déséchapper fait l'inverse : \" redevient un guillemet et \n redevient un vrai retour à la ligne. C'est presque tout le jeu de règles, et l'outil Escape Unescape de Chaines JSON l'applique exactement, dans les deux sens. La plupart des problèmes viennent de ce qui se passe autour de ces règles : du JSON collé à l'intérieur d'une autre chaîne JSON, des barres obliques inverses qui se multiplient à chaque enregistrement d'une valeur, et des caractères valides en JSON qui cassent l'endroit où on les colle. Ce guide traite chacun de ces cas.

Ce que veut dire échapper en JSON, et quels caractères le demandent

Une chaîne JSON commence et se termine par un guillemet double. Tout ce qui, à l'intérieur, pourrait être pris pour la fin de la chaîne ou pour le début d'un échappement doit être écrit autrement. La norme JSON (RFC 8259) rend obligatoire l'échappement d'exactement trois groupes de caractères : le guillemet double, la barre oblique inverse et tous les caractères de contrôle de U+0000 à U+001F, dont le retour à la ligne et la tabulation. Tout le reste, y compris les lettres accentuées, les emojis, les apostrophes et la barre oblique, peut apparaître tel quel.

CaractèreS'écrit en JSONObligatoire ?
Guillemet double "\"Oui, sinon il termine la chaîne
Barre oblique inverse \\\Oui, sinon elle ouvre un échappement
Retour à la ligne (line feed)\nOui, un vrai saut de ligne dans une chaîne est invalide
Retour chariot\rOui
Tabulation\tOui
Retour arrière, saut de page\b, \fOui
Autres contrôles U+0000 à U+001F\u0000 à \u001fOui, il n'existe pas de forme courte
Barre oblique // ou \/Non, les deux sont valides
Non-ASCII, comme é ou 😀tel quel, ou \u00e9 et la paire D83D DE00Non, les deux sont valides
Apostrophe 'tel quelNon, et \' n'est pas un échappement valide

La dernière ligne piège beaucoup de monde. JavaScript et Python acceptent \' dans une chaîne, ce qui paraît naturel, mais JSON ne le définit pas. Un analyseur qui rencontre \' s'arrête sur une erreur. En JSON, l'apostrophe n'a besoin d'aucun échappement, et les guillemets simples ne peuvent jamais servir à délimiter une chaîne.

Échapper ou déséchapper : de quoi avez-vous besoin

Votre situationSensCe que vous obtenez
Une requête SQL sur plusieurs lignes, un certificat ou un modèle doit devenir une seule valeur JSONÉchapperUne seule ligne avec \n à la place des sauts de ligne
Une chaîne pleine de guillemets doit aller dans un fichier de configuration ou un jeu de testÉchapperChaque " écrit \"
Une ligne de log ou un champ d'API se lit comme une seule rangée de \n et de \"DéséchapperLe texte lisible, avec de vrais retours à la ligne
Un champ contient un document JSON entier sous forme de chaîneDéséchapperLe document intérieur, prêt pour le Formateur JSON
Vous voulez vérifier que le texte échappé dit bien ce que vous pensezÉchapper, puis PermuterUn aller-retour qui doit rendre l'original à l'identique

Échapper n'est ni chiffrer ni compresser. Cela change seulement la façon d'écrire les caractères spéciaux pour qu'un analyseur les lise comme du texte. S'il s'agit de transformer des données binaires, comme une image, en texte, c'est un autre travail, expliqué dans ce qu'est l'encodage Base64. Si le texte doit aller dans une adresse web, il lui faut l'encodage pourcent de l'encodeur d'URL.

Échapper ou déséchapper une chaîne JSON, étape par étape

1

Choisir le sens

Ouvrez l'outil d'échappement JSON et choisissez Échapper pour transformer du texte brut en littéral de chaîne JSON, ou Déséchapper pour retransformer une chaîne JSON en texte.

2

Ajouter votre texte

Collez dans la zone et appuyez sur Utiliser ce texte, ou déposez un fichier .json, .txt, .log, .ndjson ou un autre fichier texte du même genre dans la zone de dépôt. L'UTF-8 et l'UTF-16 sont tous deux reconnus.

3

Régler les options

Pour Échapper, Entourer le résultat de guillemets est activé par défaut ; désactivez-le si vous collez le résultat entre des guillemets déjà présents dans votre code. Les trois autres options sont décrites plus bas. Pour Déséchapper, laissez Couches à retirer sur Automatique (jusqu'à 10), sauf si vous voulez vous arrêter en cours de route.

4

Lancer et regarder les compteurs

Appuyez sur Échapper ou Déséchapper. Le résultat s'affiche à côté de la source avec le nombre de caractères et d'octets et un ratio de croissance, utile quand la valeur doit tenir dans une colonne ou sous une limite de taille de requête.

5

Copier, télécharger ou permuter

Copiez le résultat, téléchargez-le en fichier texte, ou appuyez sur Permuter pour le renvoyer en entrée dans l'autre sens et vérifier que vous retrouvez votre texte d'origine.

Transformez du texte en chaîne JSON ou décodez-en une, avec les couches imbriquées retirées automatiquement. Gratuit : un fichier ou un texte collé jusqu'à 10 Mo, avec toutes les options. Pro : pas de plafond de taille fixe et jusqu'à 20 fichiers à la fois, téléchargés dans un seul ZIP. Tout s'exécute sur votre appareil, pas sur nos serveurs.

Échapper ou déséchapper du JSON

Mettre du JSON à l'intérieur d'une chaîne JSON

Il arrive qu'un document JSON entier doive voyager sous forme d'une seule chaîne : le contenu d'un webhook stocké dans une colonne de base de données, un objet de réglages qui passe par une file d'attente n'acceptant que du texte, ou le champ message d'un événement de log. On échappe alors le document. L'objet {"name":"Ana"} devient la chaîne "{\"name\":\"Ana\"}". Chaque guillemet intérieur gagne une barre oblique inverse, et l'ensemble gagne une paire de guillemets extérieurs.

Avant d'échapper un document, vérifiez qu'il est valide : échapper un objet auquel il manque une virgule donne une chaîne parfaitement valide qui contient un document cassé. Passez-le d'abord dans le Validateur JSON. Si la taille compte, retirez l'indentation avec le Minificateur JSON avant d'échapper : chaque saut de ligne d'un document indenté devient un \n de deux caractères et les espaces d'indentation sont conservés, si bien qu'un document indenté échappé est nettement plus gros qu'un document minifié échappé.

Dans l'autre sens, quand une API renvoie un champ dont la valeur commence par "{\", vous avez affaire à un document incorporé. Déséchappez-le une fois et vous récupérez du vrai JSON, que vous pouvez ensuite formater et lire.

Double échappement : pourquoi les barres obliques inverses se multiplient

À chaque échappement d'une valeur, chaque barre oblique inverse existante est doublée et chaque guillemet en gagne une de plus. Un retour à la ligne qui vaut \n après un passage devient \\n après deux et \\\\n après trois. Déséchappé une seule fois, il a toujours l'air échappé, et c'est pourquoi on croit que l'outil n'a pas marché. Il a marché : il a retiré une couche sur plusieurs.

Laissez Couches à retirer sur Automatique et l'outil continue tant que le résultat est encore une chaîne JSON entre guillemets, jusqu'à dix couches, puis indique combien il en a retiré. Choisissez un nombre de 1 à 10 pour vous arrêter à une couche intérieure, par exemple pour confier un document incorporé au formateur au lieu de le décoder davantage. Un texte ordinaire qui contient \n par hasard n'est jamais épluché, car une couche n'est retirée que si ce qui reste s'analyse réellement comme une chaîne JSON.

Les causes habituelles du double échappement, pour le corriger à la source :

  • Sérialiser deux fois. Appeler JSON.stringify en JavaScript ou json.dumps en Python sur quelque chose qui est déjà une chaîne JSON l'enveloppe une nouvelle fois. Sérialisez l'objet une seule fois, à la dernière étape.
  • Bibliothèques de journalisation. Les loggers structurés échappent le message, et certaines chaînes de traitement échappent encore l'événement entier quand elles le transmettent.
  • Échapper à la main puis par le code. Ajouter \" vous-même puis passer le texte dans un sérialiseur donne \\\".
  • Copier depuis un débogueur ou une console. Certaines consoles affichent les chaînes sous leur forme échappée. Copier cet affichage puis l'échapper encore ajoute une couche.
  • Chemins Windows. C:\Users\Ana doit s'écrire C:\\Users\\Ana en JSON. Le coller sans échappement donne \U, qui n'est pas un échappement valide, et l'échapper deux fois donne quatre barres obliques inverses par séparateur.

Échapper selon l'endroit où va la chaîne

Tout ce qui suit produit du JSON valide dans tous les cas. Les trois options supplémentaires de l'outil existent parce que la destination, elle, y tient parfois.

OptionÀ activer quandCoût
Échapper le non-ASCII en \uXXXXLa valeur traverse un système qui ne gère pas l'UTF-8 de façon fiable, ou vous voulez de l'ASCII pur dans le gestionnaire de versionsé passe de 2 octets à 6 ; un emoji de 4 octets à 12, sous forme de deux échappements
Échapper les barres obliques en \/La chaîne va dans un bloc script HTML, où </script> dans une chaîne fermerait la balise trop tôtUn octet de plus par barre oblique
Échapper les séparateurs de ligne (U+2028, U+2029)Le littéral est collé dans du code JavaScript pour d'anciens moteurs, où ces deux caractères invisibles étaient une erreur de syntaxeSix octets au lieu de trois par caractère

Coller dans du code est un cas à part. Un littéral de chaîne JSON est en général aussi une chaîne valide en JavaScript, en Python et en Go : vous pouvez donc coller le résultat échappé entre vos propres guillemets en désactivant l'option des guillemets. Dans un shell, entourez le corps JSON de guillemets simples et les guillemets doubles à l'intérieur n'ont besoin d'aucun autre échappement ; dans l'invite de commandes Windows, les chaînes entre guillemets simples n'existent pas, si bien que chaque guillemet double intérieur doit s'écrire \" pour la ligne de commande, ce qui fait une deuxième couche, distincte, par-dessus celle du JSON.

Quand le déséchappement échoue : ce que veut dire l'erreur

MessageCause habituelleSolution
La chaîne n'est jamais ferméeLa valeur a été coupée par une limite de longueur du log ou par une copie incomplèteCollez la valeur entière ou ajoutez le guillemet fermant
Séquence d'échappement inconnueUne barre oblique inverse devant une lettre que JSON ne définit pas, comme \' ou \U dans un chemin WindowsDoublez la barre oblique inverse ou échappez plutôt le texte d'origine
Échappement \u incomplet\u n'est pas suivi d'exactement quatre chiffres hexadécimaux\u12 est invalide ; écrivez \u0012
Caractère de contrôle brutUn vrai saut de ligne ou une vraie tabulation se trouve dans la chaîne, souvent après une copie depuis un terminalUtilisez plutôt Échapper sur ce texte
Contenu en trop après la chaîneDeux chaînes côte à côte, ou du texte après le guillemet fermantConvertissez une valeur à la fois
C'est un document JSON, pas une chaîneVous avez collé un objet ou un tableauUtilisez le formateur ou le validateur ; Déséchapper traite une seule chaîne

Chaque message donne la ligne et la colonne et montre le texte autour : sur une longue ligne de log, vous voyez exactement quelle barre oblique inverse pose problème au lieu de la chercher.

Questions fréquentes

Comment échapper les guillemets doubles en JSON ?

Placez une barre oblique inverse devant chacun, de sorte que " devienne \". Toute barre oblique inverse déjà présente dans le texte doit d'abord être doublée, sinon le résultat sera lu autrement. Coller le texte dans le mode Échapper fait les deux et entoure le résultat de guillemets.

Comment déséchapper une chaîne JSON en ligne ?

Choisissez Déséchapper, collez la chaîne avec ou sans ses guillemets, puis lancez. Laissez le réglage des couches sur Automatique si la valeur a pu être échappée plusieurs fois ; l'outil indique combien de couches il a retirées.

Pourquoi mon JSON a-t-il une barre oblique inverse devant chaque guillemet ?

La valeur a été stockée comme chaîne et non comme objet, généralement parce qu'elle a été sérialisée deux fois. Déséchappez-la pour récupérer le JSON intérieur, puis corrigez le code qui la sérialise pour qu'il ne le fasse qu'une fois.

Peut-on utiliser des guillemets simples ou \' en JSON ?

Non. Les chaînes JSON doivent utiliser des guillemets doubles, et \' n'est pas un échappement valide. Une apostrophe dans une chaîne entre guillemets doubles convient telle quelle, sans barre oblique inverse.

Faut-il échapper les barres obliques en JSON ?

Non. / et \/ sont tous deux valides et veulent dire la même chose. Les échapper n'aide que lorsque le JSON est placé dans une balise script HTML, où le texte </script> fermerait sinon la balise.

Quelle taille de texte peut-on échapper gratuitement ?

La version gratuite traite un fichier ou un texte collé jusqu'à 10 Mo, avec toutes les options et toutes les profondeurs de déséchappement. Pro supprime le plafond fixe, va jusqu'à ce que votre appareil peut gérer et accepte jusqu'à 20 fichiers à la fois.

À lire ensuite

Plus sur Documents →