Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Node.contains() a Node.isConnected: podstrom alebo dokument?

Pomocou `contains()` zistíš, či uzol patrí do konkrétneho podstromu, a pomocou `isConnected`, či je pripojený k dokumentu.

Verzia: 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) vráti true, ak je otherNode samotný uzol container alebo jeho priamy či nepriamy potomok v strome uzlov. Funguje aj v odpojenom podstrome. Argument je povinný: null dá výsledok false, ale vynechanie argumentu alebo odovzdanie selektora ako reťazca vyvolá TypeError.

node.isConnected je booleovská vlastnosť iba na čítanie, nie metóda. Má hodnotu true, ak je koreňom uzla po zohľadnení prechodov cez prípadných hostiteľov Shadow DOM objekt Document. Nemusí to byť aktuálny document a výsledok nič nehovorí o viditeľnosti. Po odpojení podstromu od dokumentu sa isConnected jeho uzlov zmení na false, ale vzťahy vnútri podstromu sa nezmenia.

contains() neprekračuje hranicu Shadow DOM. Uzol v tieňovom strome môže mať isConnected === true, keď je hostiteľ pripojený k dokumentu, hoci host.contains(shadowChild) vráti false. Obe sú súčasťou webového rozhrania DOM, nie ECMAScriptu 2024; ich dostupnosť závisí od prostredia, v ktorom kód beží.

Príklady

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

Výsledok

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

Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Vytvorí samostatný dokument HTML a otvorenú stránku nezmení. Po odstránení hostiteľa v ňom `child` zostane, ale `child.isConnected` bude znova `false`.

Súvisiace lekcie

  • JavaScript · Lekcia 40 · Stredne pokročilá · Verzia: 3

Zdroje