CKTIS / JavaScript
Node.contains() en Node.isConnected: deelboom of document
Gebruik `contains()` om te controleren of een knoop in een specifieke deelboom zit en `isConnected` om te bepalen of die met een document verbonden is.
Versie: 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) geeft true terug als otherNode de knoop container zelf is of een directe of indirecte afstammeling ervan in de knopenboom. Dit werkt ook in een losgekoppelde deelboom. Het argument is verplicht: null geeft false, maar als je het argument weglaat of een selector als tekenreeks meegeeft, krijg je een TypeError.
node.isConnected is een alleen-lezen booleaanse eigenschap, geen methode. De waarde is true als de wortel van de knoop, na het volgen van eventuele Shadow DOM-hosts, een Document is. Dat hoeft niet het huidige document te zijn en zegt niets over de zichtbaarheid. Als je een deelboom van een document loskoppelt, wordt isConnected voor de knopen daarin false, terwijl hun onderlinge relaties hetzelfde blijven.
contains() gaat niet over een Shadow DOM-grens heen. Een knoop in een shadow tree kan isConnected === true hebben als de host met een document verbonden is, terwijl host.contains(shadowChild) false teruggeeft. Beide zijn API’s van de web-DOM, geen functies van ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeringsomgeving.
Voorbeelden
<!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>Resultaat
self/null: true false before: true false attached: true true shadow: false true true detached: true false
Sla het voorbeeld op als HTML-bestand, open het in een browser en controleer de uitvoer in de ontwikkelaarsconsole. Het maakt een apart HTML-document aan en laat de geopende pagina ongemoeid. Na het verwijderen van de host zit `child` er nog in, maar `child.isConnected` wordt weer `false`.
Gerelateerde lessen
- JavaScript · Les 40 · Gemiddeld · Versie: 3