WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTML-Text maskieren oder die HTML-Struktur anhand einer Positivliste bereinigen

Maskierung sorgt dafür, dass eine Eingabe als wörtlicher Text erscheint. Strukturelle Bereinigung erhält ausgewählte Formatierungen anhand einer Positivliste für Elemente und Attribute.

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

Syntax

element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });

Wenn du nicht vertrauenswürdige Eingaben in einen normalen Textbereich im HTML-Quelltext einfügst, kodiere sie passend zu diesem Kontext: Ersetze etwa & durch &amp; und < durch &lt;. Der Parser liest diese Referenzen als Textzeichen, nicht als Tag-Syntax. Wenn du direkt mit dem DOM arbeitest, weise den unveränderten Wert textContent eines Elements wie div zu. Dadurch wird dessen Inhalt durch Text ersetzt, ohne HTML zu parsen. Die Maskierung von HTML-Text schützt nicht allgemein in Attributen, URLs, JavaScript oder CSS.

Soll Formatierung erhalten bleiben, bereinige die HTML-Struktur. setHTML() parst im Kontext des Zielelements, setzt die Positivliste für Elemente und Attribute durch und entfernt XSS-gefährliche Konstrukte auch dann, wenn die Konfiguration sie zulässt. Im Beispiel ist strong erlaubt, aber kein Attribut. Filtere die geparste Struktur, statt Tags mit einem regulären Ausdruck zu entfernen. Wenn deine Richtlinie Links zulässt, lege separat fest, welche URLs deine Anwendung akzeptiert.

textContent und setHTML() sind APIs der Webplattform, keine Funktionen von ECMAScript 2024. Prüfe, ob deine Zielbrowser setHTML() unterstützen. Fehlt es, verwende Klartext oder einen geprüften HTML-Sanitizer; übergib keine Rohdaten an innerHTML. Geh auch nicht davon aus, dass das serialisierte Ergebnis in einem anderen Kontext sicher geparst werden kann: Bereinige es beim Einfügen in das Zielelement.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML text escaping and structural sanitization</title>
</head>
<body>
  <pre id="output"></pre>
  <script>
    const input = '<strong title="label">A &amp; B</strong><br>';
    const text = document.createElement('div');
    const rich = document.createElement('div');

    if (typeof rich.setHTML !== 'function') {
      throw new Error('This example requires a browser that supports Element.setHTML().');
    }

    text.textContent = input;
    rich.setHTML(input, {
      sanitizer: {
        elements: ['strong'],
        attributes: [],
        comments: false,
        dataAttributes: false,
      },
    });

    document.getElementById('output').textContent =
      [text.innerHTML, rich.innerHTML].join('\n');
  </script>
</body>
</html>

Ergebnis

&lt;strong title="label"&gt;A &amp;amp; B&lt;/strong&gt;&lt;br&gt;
<strong>A &amp; B</strong>

Die erste Zeile serialisiert wörtlichen Text: Selbst die Schreibweise `&amp;` aus der Eingabe bleibt als Text erhalten. Die zweite zeigt ein echtes `strong`-Element ohne `title`-Attribut und ohne `br`-Element. Das Beispiel liest `innerHTML` nur aus.

Zugehörige Lektionen

  • JavaScript · Lektion 16 · Fortgeschritten · Version: 4

Quellen