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 propertycontainer.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