CKTIS / JavaScript
Ein Element mit querySelector() auswählen und seinen Inhalt mit innerHTML ändern
Finde das erste passende Nachfahrenelement per CSS-Selektor, behandle einen fehlenden Treffer und lies oder ersetze das Markup im ausgewählten Element.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const target = root.querySelector(selectors);
if (target !== null) {
const previousMarkup = target.innerHTML;
target.innerHTML = markup;
}Element.querySelector/innerHTML verbindet zwei Vorgänge: ein Element finden und mit seinem Inhalt arbeiten. root.querySelector(selectors) erwartet einen String mit einem CSS-Selektor oder einer kommagetrennten Selektorliste. Die Methode liefert das erste passende Nachfahrenelement in DOM-Baumreihenfolge, unabhängig von der Reihenfolge der Selektoren in der Liste. Sie liefert nie root selbst. Ohne Treffer gibt sie null zurück; ungültige Selektorsyntax löst eine DOMException namens SyntaxError aus. Prüfe das Ergebnis, bevor du eine Eigenschaft liest oder ihr einen Wert zuweist.
Das Ergebnis muss unterhalb von root liegen, aber beim Abgleich können auch Vorfahren außerhalb dieses Teilbaums eine Rolle spielen. :scope > .message erfasst nur direkte Kinder von root mit der Klasse message. Anders als document.querySelector() sucht die Methode nicht im gesamten Dokument nach einem Ergebnis.
Beim Lesen liefert target.innerHTML den serialisierten Inhalt als String, ohne die Tags des Elements selbst und ohne Shadow Roots. Eine Zuweisung parst ein Fragment im Kontext des Elements und ersetzt dessen Kinder, nicht das Element selbst. Bei einem template-Element wird stattdessen der Vorlageninhalt ersetzt. Gespeicherte Referenzen und Ereignis-Listener beziehen sich weiterhin auf die alten, ausgehängten Knoten, nicht auf die neuen. In einem XML-Dokument löst nicht wohlgeformtes Markup bei der Zuweisung SyntaxError aus. Scheitert die XML-Serialisierung beim Lesen, kann InvalidStateError auftreten. Beides sind DOMExceptions.
Weise innerHTML keine nicht vertrauenswürdigen Eingaben direkt zu: Die Eigenschaft bereinigt Markup standardmäßig nicht und kann zu XSS führen. Verwende für reinen Text textContent. Wenn du Markup aus einer nicht vertrauenswürdigen Quelle brauchst, bereinige es zuerst. Trusted Types bereinigen nichts von sich aus. Wenn die Laufzeit sie unterstützt und eine CSP sie erzwingt, führt die Zuweisung eines einfachen Strings ohne geeignete Standardrichtlinie zu TypeError. Übergib stattdessen TrustedHTML aus einer Richtlinie, die die Eingabe bereinigt.
Das sind APIs der Webplattform, nicht Teil von ECMAScript 2024. Prüfe, ob die Laufzeit ein DOM und die benötigten Sicherheitsfunktionen bereitstellt.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>querySelector() and innerHTML</title>
</head>
<body>
<script>
{
const panel = document.createElement("div");
panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';
const target = panel.querySelector(".message");
if (target !== null) {
const oldChild = target.firstElementChild;
console.log(target.innerHTML);
target.innerHTML = "<strong>After</strong>";
console.log(target.innerHTML);
console.log(oldChild.parentNode === null);
console.log(target.nextElementSibling.textContent);
}
console.log(panel.querySelector(".missing") === null);
}
</script>
</body>
</html>Ergebnis
<em>Before</em> <strong>After</strong> true Unchanged true
Speichere das Beispiel als `.html`-Datei und öffne sie im Browser ohne eine CSP, die Trusted Types erzwingt. Die Ausgabe erscheint in der Browserkonsole. Nur der erste Treffer ändert sich. Sein früheres Kind hat keinen Elternknoten mehr, das zweite Element behält den Text `Unchanged`, und die Suche ohne Treffer ergibt `null`.
Zugehörige Lektionen
- JavaScript · Lektion 18 · Fortgeschritten · Version: 4