WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 property

container.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

Quellen