Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Node.contains() et Node.isConnected : sous-arbre ou document

Utilisez `contains()` pour vérifier qu’un nœud appartient à un sous-arbre précis, et `isConnected` pour savoir s’il est relié à un document.

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

Syntaxe

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

container.contains(otherNode) renvoie true si otherNode est container lui-même ou l’un de ses descendants directs ou indirects dans l’arbre de nœuds. Cela fonctionne aussi dans un sous-arbre détaché. L’argument est obligatoire : null donne false, mais omettre l’argument ou passer un sélecteur sous forme de chaîne déclenche une TypeError.

node.isConnected est une propriété booléenne en lecture seule, pas une méthode. Elle vaut true si la racine du nœud, en remontant par les éventuels hôtes du Shadow DOM, est un Document. Il ne s’agit pas forcément du document courant, et la valeur ne dit rien sur la visibilité du nœud. Détacher un sous-arbre d’un document fait passer isConnected à false pour ses nœuds, sans modifier leurs relations à l’intérieur du sous-arbre.

contains() ne franchit pas la frontière du Shadow DOM. Un nœud dans un arbre fantôme peut avoir isConnected === true si l’hôte est relié à un document, même si host.contains(shadowChild) renvoie false. Ce sont deux API du DOM du Web, et non des fonctionnalités d’ECMAScript 2024 ; leur disponibilité dépend de l’environnement d’exécution.

Exemples

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

Résultat

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

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et vérifiez la sortie dans la console de développement. L’exemple crée un document HTML distinct et ne modifie pas la page ouverte. Après le retrait de l’hôte, `child` reste à l’intérieur, mais `child.isConnected` redevient `false`.

Leçons associées

  • JavaScript · Leçon 40 · Intermédiaire · Version : 3

Sources