WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Text im HTML-Textkontext maskieren

Beim Erzeugen von HTML muss Klartext passend zur Einfügestelle maskiert werden. Wenn du direkt in ein gewöhnliches DOM-Element schreibst, verwende stattdessen `textContent` mit der Originalzeichenfolge.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const escapeHtmlText = (text) => text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
// Use escaped text only in the ordinary text position of trusted HTML markup.
const markup = `<p>${escapeHtmlText(text)}</p>`;
// If writing directly to an ordinary DOM element, use the original string instead.
element.textContent = text;

Maskierung im HTML-Textkontext ist eine Ausgabekodierung für Klartext im HTML-Quelltext, etwa im Inhalt eines p-Elements. Ein unmaskiertes < kann ein Tag einleiten, ein & eine Zeichenreferenz. Der Parser wandelt &lt; in ein wörtliches < im Text um; er behandelt das dekodierte Zeichen nicht als Taganfang.

Ersetze bei aufeinanderfolgenden replaceAll-Aufrufen zuerst & durch &amp; und dann < durch &lt;. So werden die durch spätere Ersetzungen eingefügten & nicht erneut maskiert. Das Beispiel ersetzt zusätzlich > durch &gt;, was hier optional ist; auch Anführungszeichen müssen in diesem Kontext nicht maskiert werden. Kodiere den Rohtext nur einmal an der Einfügestelle und verzichte darauf, wenn das Template bereits automatisch kodiert.

Um den Text eines gewöhnlichen DOM-Elements festzulegen, weise die Originalzeichenfolge textContent zu. Nutze dafür nicht innerHTML, denn es parst Markup. Verwende die Funktion nicht für Attribute, URLs, JavaScript oder CSS; dafür gelten andere Regeln. Wenn ein Teil des Markups aus nicht vertrauenswürdigem HTML erhalten bleiben soll, bereinige das HTML, statt es als Text zu maskieren.

Beispiele

function escapeHtmlText(text) {
  return text.replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;');
}

const text = 'A & B <em>demo</em> &lt;';
console.log(`<p>${escapeHtmlText(text)}</p>`);

Ergebnis

<p>A &amp; B &lt;em&gt;demo&lt;/em&gt; &amp;lt;</p>

Die Konsole gibt HTML-Quelltext aus, keinen gerenderten Text. Beim Parsen entsteht ein Absatz ohne `em`-Element; das abschließende `&lt;` bleibt wörtlicher Text.

Zugehörige Lektionen

  • JavaScript · Lektion 28 · Fortgeschritten · Version: 4

Quellen