CKTIS / JavaScript
Node.contains — vérifier l’appartenance à l’arbre DOM
Node.contains vérifie si un nœud donné est le nœud lui-même ou un descendant, quel que soit son niveau. La méthode renvoie une valeur booléenne.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
node.contains(other)Node.contains est une méthode d’instance de Node, appelée sous la forme node.contains(other). Elle renvoie true lorsque other est node lui-même ou un descendant à n’importe quel niveau ; sinon, elle renvoie false. Pour null, le résultat est false.
L’argument désigne un nœud, et non un sélecteur CSS ni un texte à rechercher. Un nœud texte peut également être un descendant. Pour exclure le nœud lui-même, utilisez node !== other && node.contains(other).
C’est l’arbre DOM actuel qui compte, et non la visibilité. L’arbre n’a pas besoin d’être rattaché au document. La méthode ne franchit pas les limites du Shadow DOM : un descendant situé dans un shadow root n’est pas pour autant un descendant de son hôte. Il s’agit d’une API Web de la norme DOM, et non d’une fonctionnalité du langage ECMAScript.
Exemples
const root = document.createElement('div');
const child = document.createElement('span');
const text = document.createTextNode('Hello');
root.appendChild(child);
child.appendChild(text);
console.log(root.contains(root));
console.log(root.contains(child));
console.log(root.contains(text));
console.log(child.contains(root));
console.log(root.contains(null));
child.remove();
console.log(root.contains(text));Résultat
true true true false false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.