Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Node.contains() e Node.isConnected: sottoalbero o documento

Usa `contains()` per verificare se un nodo appartiene a un sottoalbero specifico e `isConnected` per sapere se è collegato a un documento.

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

Sintassi

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

container.contains(otherNode) restituisce true se otherNode è container stesso oppure un suo discendente diretto o indiretto nell’albero dei nodi. Funziona anche in un sottoalbero staccato. L’argomento è obbligatorio: con null restituisce false, ma ometterlo o passare una stringa contenente un selettore genera un TypeError.

node.isConnected è una proprietà booleana di sola lettura, non un metodo. Vale true se la radice del nodo, risalendo attraverso gli eventuali host dello Shadow DOM, è un Document. Non deve essere per forza il document corrente, e il risultato non indica se il nodo è visibile. Staccare un sottoalbero da un documento fa diventare isConnected false per i suoi nodi senza modificarne le relazioni interne.

contains() non attraversa il confine dello Shadow DOM. Un nodo in uno shadow tree può avere isConnected === true se l’host è collegato a un documento, anche se host.contains(shadowChild) restituisce false. Entrambe sono API del DOM del Web, non funzionalità di ECMAScript 2024; la disponibilità dipende dall’ambiente di esecuzione.

Esempi

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

Risultato

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

Salva l’esempio come file HTML, aprilo in un browser e controlla l’output nella console di sviluppo. Crea un documento HTML separato senza modificare la pagina aperta. Quando rimuovi l’host, `child` rimane al suo interno, ma `child.isConnected` torna a essere `false`.

Lezioni correlate

  • JavaScript · Lezione 40 · Intermedio · Versione: 3

Fonti