WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLElement.innerHTML: Elementinhalt lesen und ersetzen

Beim Lesen liefert `innerHTML` den Elementinhalt als Markup. Beim Zuweisen ersetzt der Parser den Inhalt durch neu erzeugte Knoten, auch bei `+=`.

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

Syntax

const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""

HTMLElement.innerHTML ist eine von Element geerbte Instanzeigenschaft, keine statische Methode. Beim Lesen erhältst du den aktuellen DOM-Inhalt als Zeichenkette, ohne die Tags des Elements selbst und ohne Shadow Roots. Die Zeichenkette bildet den DOM-Baum ab, nicht den ursprünglichen Quelltext.

Eine Zuweisung parst das Markup im Kontext des Elements und ersetzt dessen Kindknoten, nicht das Element selbst. Bei template wird der Inhalt von template.content ersetzt. Der Setter akzeptiert eine Zeichenkette oder TrustedHTML. Web IDL wandelt null vor der Trusted-Types-Prüfung in die leere Zeichenkette ("") um. Erhält der Parser diese Zeichenkette unverändert, wird der Inhalt geleert. Werden Trusted Types erzwungen, kann eine Standardrichtlinie aus der leeren Zeichenkette jedoch nichtleeres Markup erzeugen. Eine erfolgreiche Zuweisung leert den Inhalt daher nicht unbedingt. Der Setter erzeugt keine deklarativen Shadow Roots.

element.innerHTML += markup liest das serialisierte Markup, hängt den neuen Text an und parst das gesamte Ergebnis erneut. Die alten Knoten werden ausgehängt; direkt an ihnen registrierte Ereignis-Listener werden nicht auf die neuen Knoten übertragen. Wenn vorhandene Knoten erhalten bleiben sollen, füge neue mit append() hinzu.

Übergib nicht vertrauenswürdige Eingaben nie direkt an innerHTML: Standardmäßig wird nichts bereinigt. Attribute für Ereignishandler können zu XSS führen, obwohl eingefügte script-Elemente nicht ausgeführt werden. Verwende für reinen Text textContent und für benötigtes HTML einen geprüften Sanitizer. Eine Trusted-Types-Richtlinie allein garantiert keine Bereinigung.

Die Eigenschaft gehört zur Webplattform, nicht zu ECMAScript 2024. Die Unterstützung für Trusted Types hängt von der Umgebung ab. Erzwingt die CSP Trusted Types und fehlt eine Standardrichtlinie, löst die Zuweisung einer Zeichenkette TypeError aus. HTML-Parsing kann Syntaxfehler auffangen. In einem XML-Dokument kann ein nicht wohlgeformtes Fragment beim Zuweisen SyntaxError auslösen; lässt sich der Inhalt nicht als wohlgeformtes XML serialisieren, kann das Lesen InvalidStateError auslösen.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML example</title>
</head>
<body>
  <script>
    const box = document.createElement("div");
    box.innerHTML = "<strong>Hello</strong>";
    const original = box.firstElementChild;

    box.innerHTML += "<em> again</em>";

    console.log(box.innerHTML);
    console.log(box.textContent);
    console.log(original === box.firstElementChild);
    console.log(original.parentNode === null);
  </script>
</body>
</html>

Ergebnis

<strong>Hello</strong><em> again</em>
Hello again
false
true

Speichere das Beispiel als HTML-Datei, öffne sie in einem Browser ohne erzwungene Trusted Types und prüfe die Entwicklerkonsole. Die ersten beiden Zeilen zeigen Markup und Text im Vergleich. Die letzten beiden zeigen, dass der erste Knoten ersetzt wurde und keinen Elternknoten mehr hat.

Zugehörige Lektionen

  • JavaScript · Lektion 31 · Fortgeschritten · Version: 4

Quellen