HTML in JavaScript-String umwandeln: Maskierung und Prüfung

VeröffentlichtToolHTML in JS-String Konverter

Inhalt
  1. Warum dieses Problem in der Praxis auftritt
  2. So wandeln Sie ohne Tool selbst um
  3. Häufige Verwechslungen und Fehler
  4. Zusammenfassung
  5. Häufig gestellte Fragen

Wenn Sie einen HTML-Codeblock in eine JavaScript-Stringvariable übernehmen, müssen Sie Zeilenumbrüche als Daten erhalten statt als echte Umbrüche im Quelltext und nur die Anführungszeichen maskieren, die mit dem umschließenden Zeichen kollidieren. Nur dann lässt sich das Ergebnis ohne Syntaxfehler einfügen. Wer das von Hand erledigt, übersieht leicht eine Zeile oder ein Anführungszeichen, und der Fehler zeigt sich erst zur Laufzeit. Dieser Artikel erklärt, warum der Modus mit doppelten bzw. einfachen Anführungszeichen anders funktioniert als der Backtick-Modus (Template Literal) und was Sie prüfen sollten, bevor Sie das Ergebnis in Ihren Code einfügen.

Kurzfassung ① Im Modus mit doppelten oder einfachen Anführungszeichen wird der String zeilenweise getrennt und mit "\n" und + wieder zusammengesetzt. Ein normaler String kann im Quelltext keinen echten Zeilenumbruch enthalten. ② Der Backtick-Modus lässt Zeilenumbrüche unverändert und maskiert nur den Backtick (`) und ${. Template Literals sind von Haus aus dafür gedacht, mehrere Zeilen unverändert aufzunehmen. ③ Tritt nach der Umwandlung ein Syntaxfehler auf, wurde meist das umschließende Zeichen von Hand ausgetauscht, oder es wurde nur ein Teil des mehrzeiligen Ergebnisses kopiert, sodass das Semikolon der letzten Zeile fehlt.

Warum dieses Problem in der Praxis auftritt

Oft muss ein ganzer HTML-Markup-Block in einer einzigen JavaScript-Stringvariablen stehen, etwa bei Widget-Skripten für statische Seiten, bei Code zum E-Mail-Versand oder bei Content-Skripten von Browser-Erweiterungen. Typisch ist die Situation, dass eine Entwicklerin oder ein Entwickler ein HTML-Fragment von Designern oder Frontend-Entwicklern unverändert in eine Codedatei übernimmt.

Kopiert man das HTML einfach und fügt es zwischen Anführungszeichen ein, kollidieren Anführungszeichen in Tag-Attributen wie class="box" mit den umschließenden Anführungszeichen, und der String bricht an dieser Stelle ab. Hinzu kommt: HTML besteht meist aus mehreren Zeilen, aber normale JavaScript-Strings erlauben keine echten Zeilenumbrüche im Quelltext.

Zeilenumbrüche und Anführungszeichen müssen also jeweils nach festen Regeln behandelt werden, und diese Regeln hängen davon ab, mit welcher Art von Anführungszeichen der String umschlossen wird.

So wandeln Sie ohne Tool selbst um

Wenn Sie das Prinzip kennen, können Sie es auch von Hand umsetzen. Legen Sie zuerst fest, womit der String umschlossen werden soll.

Umwandlung im Modus mit doppelten oder einfachen Anführungszeichen

Wenn Sie doppelte (") oder einfache (') Anführungszeichen wählen, gehen Sie so vor:

  1. Teilen Sie das HTML an jedem Zeilenumbruch in einzelne Zeilen.
  2. Steht in einer Zeile ein Backslash (), maskieren Sie ihn zuerst als \.
  3. Setzen Sie in dieser Zeile vor jedes Zeichen, das dem umschließenden Zeichen entspricht (bei doppelten Anführungszeichen ", bei einfachen '), ein .
  4. Hängen Sie am Zeilenende "\n" als Zeichen für den Zeilenumbruch an und umschließen Sie die ganze Zeile mit Anführungszeichen.
  5. Hängen Sie an jede Zeile außer der letzten den Verkettungsoperator + an, damit sie sich mit dem String der nächsten Zeile verbindet. Nur an die letzte Zeile kommt statt + das Semikolon ; als Abschluss der Anweisung.

Der Grund für das Zerlegen und erneute Verketten mit + ist einfach: Ein normaler String in "..." oder '...' gilt als nicht beendet, sobald mitten im Quelltext ein echtes Zeilenumbruchzeichen steht, und das führt zu einem Fehler.

Deshalb wird der echte Zeilenumbruch durch das Zeichen "\n" ersetzt, und der Zeilenumbruch im Quelltext wird nachgebildet, indem mehrere Strings mit dem Operator + aneinandergehängt werden.

Umwandlung im Backtick-Modus

Wenn Sie Backticks (`) wählen, ist es anders. Sie müssen die Zeilen nicht zerlegen, sondern setzen das gesamte HTML unverändert zwischen zwei Backticks. Template Literals, die mit ES6 eingeführt wurden, sind von Anfang an so gedacht, dass sie echte Zeilenumbrüche im Quelltext unverändert aufnehmen können.

In diesem Fall müssen Sie nur zwei Dinge maskieren. Kommt im Original ein Backtick () vor, ersetzen Sie ihn durch \. Kommt das Zeichen ${ vor, mit dem Ausdrücke in den String eingebettet werden, ersetzen Sie es durch ${.

Lassen Sie ${ unverändert, versucht JavaScript, den folgenden Text als Code auszuwerten, was zu unerwünschtem Verhalten oder zu Fehlern führt. Normale Anführungszeichen (", ') dagegen sind im Backtick-Modus gewöhnliche Zeichen ohne besondere Bedeutung und müssen nicht maskiert werden.

Wenn Sie umfangreiches HTML nach diesen Regeln von Hand bearbeiten, vergessen Sie leicht in einer einzigen Zeile einen Backslash oder ein Anführungszeichen. Die Regeln selbst sind mit dem Obigen vollständig beschrieben, es geht also nur darum, die Routinearbeit zu verringern. Mit unserem Tool prüfen.

HTML in JS-String Konverter

Wandelt HTML in JS-String-Deklarationen um, wahlweise mit doppelten Anführungszeichen, einfachen Anführungszeichen oder Backticks. Keine Installation und keine Anmeldung nötig.

Häufige Verwechslungen und Fehler

ModusBehandlung von ZeilenumbrüchenMaskierte Zeichen
Doppelte Anführungszeichen "zeilenweise getrennt, mit "\n" + verbundendoppeltes Anführungszeichen ("), Backslash ()
Einfache Anführungszeichen 'zeilenweise getrennt, mit "\n" + verbundeneinfaches Anführungszeichen ('), Backslash ()
Backtick `bleiben unverändert (keine Trennung der Zeilen)Backtick (`), ${

Der häufigste Fehler ist, nach der Umwandlung nur das umschließende Zeichen von Hand auszutauschen. Ein Beispiel: Sie haben im Backtick-Modus umgewandelt und ersetzen die Backticks später von Hand durch doppelte Anführungszeichen. Damit entsteht ein Problem.

Der Backtick-Modus hat " und ' von vornherein nicht maskiert. Die Anführungszeichen in den HTML-Attributen bleiben also stehen und beenden den String mittendrin. Brauchen Sie ein Ergebnis mit doppelten Anführungszeichen, wählen Sie im Tool erneut den Modus für doppelte Anführungszeichen und wandeln neu um.

Der zweite Fehler ist, nach einer Änderung der Eingabe die Umwandeln-Schaltfläche nicht erneut zu drücken. Dieses Tool berechnet nicht automatisch neu, wenn sich der Inhalt des Eingabefelds ändert. Das Ergebnis wird erst aktualisiert, wenn Sie auf „In JS-String umwandeln“ klicken. Kopieren Sie nach einer HTML-Änderung das alte Ergebnis, stimmen Code und tatsächliche Darstellung nicht mehr überein.

Der dritte Fehler ist, nur einen Teil des mehrzeiligen Ergebnisses zu kopieren. Im Modus mit doppelten oder einfachen Anführungszeichen enden fast alle Zeilen mit +, und nur die letzte Zeile endet mit einem Semikolon. Kopieren Sie das Ende des Ergebnisses nicht mit, bleibt eine unvollständige Anweisung zurück, die mit + endet, ohne dass etwas folgt. Hängen Sie umgekehrt anderen Code unmittelbar hinter das Ergebnis, steht hinter einer bereits mit Semikolon beendeten Anweisung ein unpassendes Token, und es kommt zu einem Fehler.

Zusammenfassung

  • Normale Strings (", ') können im Quelltext keine echten Zeilenumbrüche enthalten. Deshalb zerlegen die Modi mit doppelten und einfachen Anführungszeichen den Text zeilenweise und verbinden ihn mit "\n" +.
  • Template Literals mit Backticks nehmen mehrere Zeilen unverändert auf. Sie müssen die Zeilen nicht zerlegen, sondern maskieren nur den Backtick und ${.
  • Der Backtick-Modus maskiert normale Anführungszeichen nicht. Tauschen Sie nach der Umwandlung deshalb nicht von Hand nur das umschließende Zeichen aus.
  • Prüfen Sie vor dem Einfügen, ob die letzte Zeile mit einem Semikolon endet und alle Zeilen davor mit + verbunden sind.
  • Haben Sie die Eingabe geändert, müssen Sie die Umwandeln-Schaltfläche erneut drücken, um das aktuelle Ergebnis zu erhalten.
HTML in JS-String Konverter

Wandelt HTML in JS-String-Deklarationen um, wahlweise mit doppelten Anführungszeichen, einfachen Anführungszeichen oder Backticks. Keine Installation und keine Anmeldung nötig.

Häufig gestellte Fragen

Warum maskiert der Backtick-Modus keine Anführungszeichen?

Weil " und ' in einem Backtick-String keine Begrenzer, sondern gewöhnliche Zeichen sind. JavaScript erkennt als Ende des Strings nur den Backtick, mit dem er begonnen hat. Maskiert werden müssen daher nur der Backtick selbst und ${ zum Einbetten von Ausdrücken.

Nach dem Einfügen des Ergebnisses erscheint ein Syntaxfehler. Woran liegt das?

Meist ist es einer von zwei Gründen: Entweder haben Sie das HTML geändert und das alte Ergebnis kopiert, ohne die Umwandeln-Schaltfläche erneut zu drücken. Oder Sie haben nur einen Teil des mehrzeiligen Ergebnisses kopiert, sodass das Semikolon der letzten Zeile fehlt oder anderer Code falsch angehängt wurde. Am schnellsten prüfen Sie es, indem Sie das gesamte Ergebnisfeld noch einmal vom Anfang bis zum Ende kopieren.

Was passiert, wenn im Original-HTML ein Backslash vorkommt?

Im Modus mit doppelten oder einfachen Anführungszeichen wird auch der Backslash in jeder Zeile maskiert und deshalb als \ doppelt geschrieben. Wenn Sie Text mit Backslashes verarbeiten, etwa Pfade oder reguläre Ausdrücke, ist es normal, dass im Ergebnis zwei statt einem Backslash stehen.

Darf ich das im Backtick-Modus umgewandelte Ergebnis später in einen String mit doppelten Anführungszeichen ändern?

Das empfehlen wir nicht. Der Backtick-Modus maskiert " und ' nicht. Tauschen Sie nur das umschließende Zeichen von Hand aus, bleiben die Anführungszeichen in den HTML-Attributen stehen und beenden den String zu früh. Brauchen Sie ein Ergebnis mit doppelten Anführungszeichen, wählen Sie im Tool erneut den Modus für doppelte Anführungszeichen und wandeln neu um.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. HTML Leerzeichen entfernen: Was beim Komprimieren wegfälltBeim HTML-Komprimieren fallen nur Leerraum und Kommentare weg. So bleiben script, style, pre und textarea intakt, und so wird die Ersparnis berechnet.
  2. htpasswd-Generator: .htpasswd-Datei ohne Installation erstellenSo erzeugen Sie im Browser eine .htpasswd-Zeile für Basic-Auth bei Apache und Nginx. Aufbau Benutzername:Hash und {SHA}/{SHA256} ohne htpasswd-Befehl.
  3. HTTP-Statuscode 401 vs. 403: Unterschiede im Überblick401 Unauthorized oder 403 Forbidden, 400 oder 404, 502, 503 und 504: So ordnen Sie HTTP-Statuscodes nach Klasse ein und erkennen typische Ursachen.
  4. Bild in Base64 umwandeln: Ergebnis verstehen und richtig nutzenWarum Base64 die Dateigröße um 33 % erhöht, worin sich Data-URL und reines Base64 unterscheiden und welche Stolperfallen es beim Auswerten des Ergebnisses gibt.
  5. Inline-Style in CSS-Klassen umwandeln: So funktioniert esSo vergibt ein Konverter Klassennamen, zerlegt style-Werte am Semikolon und behandelt vorhandene class-Attribute, wenn er Inline-Styles in CSS auslagert.
  6. IPv6 verkürzen: Regeln für :: und ausgeschriebene AdressenIPv6-Adressen kürzen und ausschreiben: führende Nullen weglassen, :: nur einmal und nur für den längsten Nullblock – mit Beispielen und IPv4-Mapping erklärt.

Passende Tools