Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Node.contains() i Node.isConnected: poddrzewo a dokument

Użyj `contains()`, aby sprawdzić przynależność do poddrzewa konkretnego węzła, a `isConnected`, aby sprawdzić, czy węzeł jest połączony z dokumentem.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected              // boolean; read-only property

container.contains(otherNode) zwraca true, gdy otherNode jest samym węzłem container albo jego bezpośrednim lub pośrednim potomkiem w drzewie węzłów. Działa również w odłączonym poddrzewie. Argument jest wymagany: null daje false, ale pominięcie argumentu lub przekazanie selektora jako tekstu powoduje TypeError.

node.isConnected to właściwość logiczna tylko do odczytu, a nie metoda. Zwraca true, jeśli korzeń węzła po uwzględnieniu przejść przez hosty Shadow DOM jest obiektem Document. Nie musi to być bieżący document, a wynik nie mówi nic o widoczności. Po odłączeniu poddrzewa od dokumentu isConnected jego węzłów zmienia się na false, ale relacje wewnątrz poddrzewa pozostają bez zmian.

contains() nie przekracza granicy Shadow DOM. Węzeł w drzewie cienia może mieć isConnected === true, gdy host jest połączony z dokumentem, mimo że host.contains(shadowChild) zwraca false. Oba API należą do webowego DOM, a nie do ECMAScript 2024; ich dostępność zależy od środowiska wykonawczego.

Przykłady

<!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>

Wynik

self/null: true false
before: true false
attached: true true
shadow: false true true
detached: true false

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Przykład tworzy osobny dokument HTML i nie zmienia otwartej strony. Po usunięciu hosta nadal zawiera on `child`, ale `child.isConnected` znów ma wartość `false`.

Powiązane lekcje

  • JavaScript · Lekcja 40 · Średniozaawansowany · Wersja: 3

Źródła