KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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 property

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

Bronnen