База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Node.contains() и Node.isConnected: поддърво или документ?

Използвай `contains()`, за да провериш дали даден възел е в конкретно поддърво, а `isConnected` — дали е свързан с документ.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

container.contains(otherNode) връща true, ако otherNode е самият възел container или негов пряк или непряк потомък в дървото от възли. Методът работи и в отделено поддърво. Аргументът е задължителен: null дава false, но пропускането на аргумента или подаването на селектор като низ предизвиква TypeError.

node.isConnected е булево свойство само за четене, а не метод. Стойността му е true, ако коренът на възела след преминаване през евентуалните хостове на Shadow DOM е обект Document. Това не е непременно текущият document, а резултатът не показва дали възелът е видим. При отделяне на поддърво от документа isConnected става false за възлите му, без да се променят връзките между тях в поддървото.

contains() не преминава границата на Shadow DOM. Възел в сенчесто дърво може да има isConnected === true, когато хостът е свързан с документ, въпреки че host.contains(shadowChild) връща false. И двете са част от уеб DOM, а не от ECMAScript 2024; наличността им зависи от средата за изпълнение.

Примери

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

Резултат

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

Запази примера като HTML файл, отвори го в браузър и провери изхода в конзолата за разработчици. Примерът създава отделен HTML документ, без да променя отворената страница. След премахването на хоста `child` остава в него, но `child.isConnected` отново става `false`.

Свързани уроци

  • JavaScript · Урок 40 · Средно · Версия: 3

Източници