CKTIS / JavaScript
Node.contains() und Node.isConnected: Teilbaum oder Dokument
Mit `contains()` prüfst du, ob ein Knoten zu einem bestimmten Teilbaum gehört. `isConnected` prüft, ob der Knoten mit einem Dokument verbunden ist.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected // boolean; read-only propertycontainer.contains(otherNode) gibt true zurück, wenn otherNode der Knoten container selbst oder einer seiner direkten oder indirekten Nachfahren im Knotenbaum ist. Das funktioniert auch in einem losgelösten Teilbaum. Das Argument ist erforderlich: null ergibt false; ohne Argument oder mit einem Selektor als Zeichenkette wird ein TypeError ausgelöst.
node.isConnected ist eine schreibgeschützte boolesche Eigenschaft, keine Methode. Ihr Wert ist true, wenn die Wurzel des Knotens unter Einbeziehung etwaiger Shadow-DOM-Hosts ein Document ist. Das muss nicht das aktuelle document sein, und der Wert sagt nichts über die Sichtbarkeit aus. Wird ein Teilbaum vom Dokument getrennt, wechselt isConnected für seine Knoten auf false, ohne dass sich ihre Beziehungen innerhalb des Teilbaums ändern.
contains() überschreitet keine Shadow-DOM-Grenze. Ein Knoten in einem Shadow Tree kann bei mit einem Dokument verbundenem Host isConnected === true haben, obwohl host.contains(shadowChild) false zurückgibt. Beides sind APIs des Web-DOM, keine Funktionen von ECMAScript 2024; ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM checks</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument("DOM checks");
const host = doc.createElement("div");
const child = doc.createElement("span");
const shadow = host.attachShadow({ mode: "open" });
const shadowChild = doc.createElement("span");
host.appendChild(child);
shadow.appendChild(shadowChild);
const report = (label) => {
console.log(`${label}: ${host.contains(child)} ${child.isConnected}`);
};
console.log(`self/null: ${host.contains(host)} ${host.contains(null)}`);
report("before");
doc.body.appendChild(host);
report("attached");
console.log(`shadow: ${host.contains(shadowChild)} ${shadow.contains(shadowChild)} ${shadowChild.isConnected}`);
host.remove();
report("detached");
}
</script>
</body>
</html>Ergebnis
self/null: true false before: true false attached: true true shadow: false true true detached: true false
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Das Beispiel erstellt ein separates HTML-Dokument und lässt die geöffnete Seite unverändert. Nach dem Entfernen des Hosts bleibt `child` darin, aber `child.isConnected` wird wieder `false`.
Zugehörige Lektionen
- JavaScript · Lektion 40 · Mittlere Stufe · Version: 3