CKTIS / JavaScript
Element.innerHTML und Sicherheitsgrenzen beim Einfügen von Text
Entscheide zwischen dem Parsen von Markup und dem wörtlichen Einfügen von Text. Erfahre, wie du DOM-XSS vermeidest und was erzwungene Trusted Types ändern.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.Beim Lesen von Element.innerHTML erhältst du den serialisierten Inhalt des Elements, nicht dessen äußeres Tag. Beim Schreiben in einem HTML-Dokument wird ein Fragment im Kontext des Elements geparst und ersetzt normalerweise dessen bisherige Kindknoten. Bei einem HTML-Element <template> wird beim Lesen der Inhalt von template.content serialisiert; beim Schreiben werden die Kindknoten dieses DocumentFragment ersetzt, nicht die des Elements selbst. Auch element.innerHTML += fragment ersetzt Knoten, statt nur neue anzuhängen: Der Ausdruck liest den serialisierten Inhalt und parst dann die zusammengesetzte Zeichenfolge erneut.
Bei einem Element liefert Node.textContent den zusammengefügten Text seiner Nachkommen, nicht deren Markup. Eine nicht leere Zeichenfolge ersetzt die Kindknoten durch einen Textknoten; eine leere entfernt sie. Um die vorhandenen Kindknoten zu behalten, füge Text mit append(text) am Ende oder mit insertAdjacentText(position, text) an einer gewählten Position relativ zum Element ein. Keine dieser Textoperationen interpretiert Markup oder Zeichenreferenzen in der Zeichenfolge.
Übergib keine nicht vertrauenswürdigen Zeichenfolgen an innerHTML: Diese HTML-Injektionsstelle kann zu DOM-XSS führen. So eingefügte script-Elemente werden nicht ausgeführt, andere Mechanismen wie Ereignishandler-Attribute können aber weiterhin Code ausführen. Zeige nicht vertrauenswürdigen Text in einem gewöhnlichen Element wie div an. Das Einfügen als Text macht dieselben Daten weder in einem Skript-, Stil- oder URL-Kontext noch beim späteren Parsen als HTML sicher.
Wenn du formatiertes HTML aus einer nicht vertrauenswürdigen Quelle brauchst, nutze setHTML(), sofern es unterstützt wird, oder bereinige das HTML vor dem Einfügen mit einem geprüften Sanitizer. Weiche nie auf eine ungefilterte Zuweisung an innerHTML aus. Erzwingt die CSP Trusted Types und fehlt eine Standardrichtlinie, löst die Zuweisung einer gewöhnlichen Zeichenfolge an innerHTML einen TypeError aus. TrustedHTML garantiert keine Bereinigung: Die Sicherheit hängt von der erzeugenden Richtlinie ab. Das sind Webplattform-APIs, keine ECMAScript-Funktionen. Prüfe die Unterstützung der eingesetzten Schutzmechanismen.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
const sample = "<em>A & B</em>";
const parsed = document.createElement("div");
const literal = document.createElement("div");
parsed.innerHTML = sample;
literal.textContent = sample;
console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>Ergebnis
innerHTML: 1 | A & B textContent: 0 | <em>A & B</em>
Speichere das Beispiel als HTML-Datei, öffne sie in einem Browser ohne Trusted-Types-Pflicht und prüfe die Ausgabe in der Browserkonsole. Die feste Zeichenfolge ist harmlos: Beim Parsen entsteht ein `em`-Element, und die Zeichenreferenz wird zu `&` dekodiert. Beim Einfügen als Text bleibt die ganze Zeichenfolge erhalten, ohne dass ein Kindelement entsteht.
Zugehörige Lektionen
- JavaScript · Lektion 15 · Fortgeschritten · Version: 4