Strings escapen: Was sich in JSON und JavaScript ändert

Inhalt
Wenn Sie Text mit Anführungszeichen, Backslashes und Zeilenumbrüchen unverändert in einen JSON- oder JavaScript-String einfügen, bricht der String mittendrin ab oder es entsteht ein Syntaxfehler. Beim Escapen ersetzen Sie solche Zeichen innerhalb des Strings einzeln durch eine sichere Schreibweise, beim Unescapen läuft es genau umgekehrt.
Dieser Artikel zeigt in einer Tabelle, in was sich jedes Sonderzeichen des Originals im Ergebnis genau verwandelt, und ordnet die häufigsten Fehler unter der Frage ein, wie man das Ergebnis richtig liest.
Zusammenfassung ① Beim Escapen wird der Originaltext Zeichen für Zeichen durchlaufen: Backslashes werden zu
\\, das gewählte Anführungszeichen zu\", Zeilenumbrüche zu\n, Tabs zu\tund alle übrigen Steuerzeichen unterhalb von 0x20 zu\uXXXX. ② Das Unescapen arbeitet in Gegenrichtung und wandelt Schreibweisen wie\n,\toder\uXXXXin die ursprünglichen Zeichen zurück. Stehen noch äußere Anführungszeichen um den Text, sollten Sie sie über die Option zum automatischen Entfernen abziehen, sonst stimmt das Ergebnis nicht. ③ Häufige Fehlerquellen: Der Backslash wird nicht zuerst behandelt und deshalb doppelt umgewandelt, oder das Anführungszeichen im Eingabetext unterscheidet sich vom gewählten, sodass ein unerwartetes Ergebnis herauskommt.
Beim Einfügen bricht der String am Anführungszeichen ab, und der Zeilenumbruch löst einen Fehler aus
Stellen Sie sich vor, Sie müssen eine mehrzeilige Log-Meldung oder einen API-Antworttext als einzelnen Wert in eine JSON-Konfigurationsdatei einsetzen. Der Text enthält in der Regel doppelte Anführungszeichen, und weil er mehrzeilig ist, auch echte Zeilenumbrüche.
Fügen Sie ihn unverändert zwischen "..." ein, kollidieren die doppelten Anführungszeichen im Text mit denen, die den String umschließen, und der String endet an dieser Stelle vorzeitig. Hinzu kommt: JSON und normale JavaScript-Strings erlauben keine echten Zeilenumbruchzeichen im Wert, sodass an jeder Zeilenschaltung ein Syntaxfehler auftritt.
Auch Windows-Pfade sind ein häufiger Fall. Setzen Sie C:\new\test unverändert in einen String ein, werden \n und \t als Zeilenumbruch und Tab interpretiert, und der ausgegebene Wert weicht vom Original ab. Solche Zeichen in eine „im String sichere Schreibweise“ zu überführen, ist genau das Escapen.
So escapen Sie manuell ohne Tool
Das Prinzip ist einfach: Sie lesen den Originaltext von links nach rechts Zeichen für Zeichen und ersetzen nur die Zeichen, die ein String-Literal beschädigen können, durch die vorgesehene Schreibweise. Die Reihenfolge ist dabei wichtig.
- Legen Sie das umschließende Anführungszeichen fest. Je nachdem, ob das Ergebnis in ein Literal mit doppelten Anführungszeichen, einfachen Anführungszeichen oder Backticks kommt, ändert sich, was escapet werden muss. Standard sind doppelte Anführungszeichen.
- Ersetzen Sie zuerst die Backslashes. Ein Backslash (
\) wird zu\\. Dieser Schritt muss ganz am Anfang stehen, damit nicht die Backslashes, die Sie erst beim späteren Escapen der Anführungszeichen einfügen, ein zweites Mal verarbeitet werden. - Ersetzen Sie das gewählte Anführungszeichen. Setzen Sie vor das gewählte Anführungszeichen einen Backslash. Haben Sie doppelte Anführungszeichen gewählt, wird aus
"ein\". Anführungszeichen der anderen, nicht gewählten Art bleiben unberührt. - Ersetzen Sie Zeilenumbruch-Zeichen durch ihre Schreibweise. Der Zeilenumbruch wird zu
\n, der Wagenrücklauf (Carriage Return) zu\r, der Tab zu\t, der Backspace zu\bund der Seitenvorschub (Form Feed) zu\f. - Behandeln Sie die übrigen Steuerzeichen. Steuerzeichen unterhalb von 0x20, die oben keinen eigenen Namen haben (Null, vertikaler Tab, ESC usw.), werden zur Form
\uXXXX:\ugefolgt von vier Hexadezimalziffern.
Die Zuordnung der einzelnen Originalzeichen zum Ergebnis sieht so aus:
| Originalzeichen | Ergebnis nach dem Escapen |
|---|---|
Backslash \ | \\ |
Gewähltes Anführungszeichen (Standard ") | \" |
| Zeilenumbruch (LF) | \n |
| Wagenrücklauf (CR) | \r |
| Tab | \t |
| Backspace | \b |
| Seitenvorschub | \f |
| Sonstige Steuerzeichen unterhalb von 0x20 | \uXXXX |
Dazu gibt es zwei weitere Optionen. Schalten Sie In Anführungszeichen setzen ein, wird das gesamte Ergebnis einmal in das gewählte Anführungszeichen eingefasst, sodass Sie ein sofort einsetzbares Literal erhalten. Mit Nicht-ASCII ebenfalls als \u escapen werden auch Zeichen außerhalb des ASCII-Bereichs wie Umlaute, Hangul oder Emojis zu \uXXXX. Zeichen oberhalb von U+FFFF (die meisten Emojis) werden dabei in zwei Surrogate-Paare (\uXXXX\uXXXX) aufgeteilt.
Das Unescapen in Gegenrichtung kehrt die Regeln um. Trifft es auf ein \, schaut es auf das nächste Zeichen: \n, \r, \t, \b, \f, \v und \0 werden zum jeweiligen Steuerzeichen, \xXX, \uXXXX und \u{XXXXX} zum Zeichen mit dem entsprechenden Code, und escapte Anführungszeichen, Backslashes und Slashes werden wieder zu den ursprünglichen Symbolen. Umschließt dasselbe Anführungszeichen den String an beiden Enden, wird dieses Paar entfernt.
Einen Unterschied zwischen den Richtungen gibt es: Das Escapen gibt vertikalen Tab und Nullzeichen nicht als \v und \0 aus, sondern als \u000b und \u0000. Das Unescapen erkennt dagegen auch die Schreibweisen \v und \0 und wandelt sie in das ursprüngliche Zeichen um.
Direkt mit unserem Tool String-Escape prüfen.
Wandeln Sie Text im Browser in beide Richtungen um: escapen und unescapen. Keine Installation, keine Anmeldung, und der eingegebene Text wird nicht an einen Server gesendet.

Das Ergebnis richtig lesen: drei typische Fehlerquellen
Die Regeln selbst sind mit dem Obigen vollständig beschrieben. Dass das Ergebnis anders ausfällt als erwartet, liegt meist an einer der folgenden drei Stellen.
| Situation | Warum das Ergebnis abweicht | So korrigieren Sie es |
|---|---|---|
| Backslash wird zu spät behandelt | Der Backslash des zuvor eingefügten \" wird erneut zu \\ verdoppelt | Backslashes zuerst escapen |
| Anführungszeichen im Eingabetext ≠ gewähltes Anführungszeichen | Nur das gewählte Anführungszeichen wird ersetzt, das andere bleibt unverändert | Dasselbe Anführungszeichen wählen wie beim umschließenden Literal |
| Beim Unescapen bleiben äußere Anführungszeichen stehen | Das führende und das abschließende " mischen sich in den Text, und das Ergebnis verschiebt sich um ein Zeichen | Automatisches Entfernen der äußeren Anführungszeichen einschalten |
Reihenfolgeproblem beim Backslash. Wenn Sie von Hand arbeiten und zuerst die Anführungszeichen ersetzen, werden die dabei neu eingefügten Backslashes im nächsten Schritt noch einmal zu \\. Ein Tool durchläuft den Originaltext nur ein einziges Mal von links nach rechts und liest neu eingefügte Backslashes nicht erneut, sodass diese Doppelverarbeitung gar nicht erst entsteht.
Unterschiedliche Anführungszeichen. Soll der Text in ein Literal mit einfachen Anführungszeichen, Sie escapen ihn aber im Modus für doppelte Anführungszeichen, bleiben die einfachen Anführungszeichen im Text unverändert. Fügen Sie das Ergebnis dann in '...' ein, bricht der String an einem der verbliebenen einfachen Anführungszeichen ab. Prüfen Sie daher zuerst, ob das Anführungszeichen, das Ihr Ergebnis umschließen soll, dem im Tool gewählten entspricht.
Äußere Anführungszeichen beim Unescapen. Wenn Sie einen von Anführungszeichen umschlossenen String wie "Haus\tHello" zurückwandeln und diese Anführungszeichen nicht entfernen, bleibt vor und hinter dem Ergebnis jeweils ein Anführungszeichen stehen. Ist das automatische Entfernen der äußeren Anführungszeichen aktiv, wird dieses Paar nur dann abgezogen, wenn das erste und das letzte Zeichen dasselbe Anführungszeichen sind.
Zusammenfassung
- Beim Escapen wird der Originaltext Zeichen für Zeichen gelesen: Backslash →
\\, gewähltes Anführungszeichen →\", Zeilenumbruch →\n, Tab →\t, sonstige Steuerzeichen unterhalb von 0x20 →\uXXXX. - Von Hand müssen Sie den Backslash zuerst behandeln, um eine Doppelverarbeitung zu vermeiden. Ein Tool durchläuft den Text nur einmal und umgeht dieses Problem automatisch.
- Was escapet wird, hängt vom gewählten Anführungszeichen ab. Wählen Sie dieselbe Art wie beim Literal, in das das Ergebnis kommt, dann stimmt das Ergebnis.
- Das Unescapen wandelt in Gegenrichtung
\n,\uXXXXusw. zurück. Äußere Anführungszeichen sollten Sie über die Option zum automatischen Entfernen abziehen, damit sich das Ergebnis nicht verschiebt. - Mit der Option „Nicht-ASCII ebenfalls als \u escapen“ werden Hangul und Emojis zu
\uXXXX, Zeichen oberhalb von U+FFFF zu Surrogate-Paaren.
Wandeln Sie Text im Browser in beide Richtungen um: escapen und unescapen. Keine Installation, keine Anmeldung, und der eingegebene Text wird nicht an einen Server gesendet.
Häufige Fragen
Was ist der Unterschied zwischen Escapen und Unescapen?
Die beiden Vorgänge laufen in entgegengesetzter Richtung ab. Beim Escapen wird der Originaltext, wie Menschen ihn lesen, in eine Schreibweise umgewandelt, die sich in ein String-Literal einsetzen lässt (z. B. \n oder \"). Beim Unescapen wird diese Schreibweise wieder in die ursprünglichen Zeichen zurückverwandelt. Über die Tabs oben im Tool wechseln Sie zwischen den beiden Richtungen. Bei jeder Änderung der Eingabe werden das Ergebnis sowie die Zeichenanzahl von Eingabe und Ergebnis sofort neu berechnet.
Kann ich auch Hangul oder Emojis in \u-Sequenzen umwandeln?
Wenn Sie die Option „Nicht-ASCII-Zeichen als \u escapen“ aktivieren, werden auch Zeichen außerhalb des ASCII-Bereichs, etwa Hangul oder Emojis, in die Form \uXXXX umgewandelt. Zeichen oberhalb von U+FFFF, also die meisten Emojis, werden dabei in zwei Surrogatpaar-Hälften aufgeteilt. Ist die Option deaktiviert, bleiben solche Zeichen unverändert.
Ich setze das Ergebnis in einfache Anführungszeichen, warum bleiben doppelte Anführungszeichen unverändert?
Ist als Anführungszeichen das doppelte ausgewählt, werden nur doppelte Anführungszeichen escaped. Einfache Anführungszeichen im Text bleiben unberührt. Wenn Sie das Ergebnis in '...' einsetzen wollen, müssen Sie die Auswahl auf einfache Anführungszeichen umstellen, damit sie als \' escaped werden. Entscheidend ist, dass Sie dasselbe Anführungszeichen wählen wie beim Literal, in das der String eingesetzt wird.
Nach dem Unescapen stehen am Anfang und Ende noch Anführungszeichen.
Wenn der eingegebene String an beiden Enden von Anführungszeichen umschlossen ist und die Option „Äußere Anführungszeichen automatisch entfernen“ deaktiviert ist, werden diese Anführungszeichen als Teil des Textes behandelt und bleiben vor und hinter dem Ergebnis stehen. Ist die Option aktiviert und sind das erste und das letzte Zeichen dasselbe Anführungszeichen (doppeltes, einfaches oder Backtick), wird nur dieses eine Paar entfernt, und anschließend wird der Rest zurückverwandelt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen