CKTIS / JavaScript
Node.contains — comprobar la pertenencia al árbol DOM
Node.contains comprueba si un nodo dado es el propio nodo o un descendiente a cualquier profundidad. Devuelve un valor booleano.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
node.contains(other)Node.contains es un método de instancia de Node que se llama como node.contains(other). Devuelve true cuando other es el propio node o un descendiente a cualquier profundidad; en caso contrario, devuelve false. Para null, el resultado es false.
El argumento representa un nodo, no un selector CSS ni un texto que se deba buscar. Un nodo de texto también puede ser un descendiente. Para excluir el propio nodo, usa node !== other && node.contains(other).
Lo que importa es el árbol DOM actual, no la visibilidad. No es necesario que el árbol esté conectado al documento. El método no atraviesa los límites del Shadow DOM: un descendiente dentro de un shadow root no pasa por ello a ser descendiente de su host. Es una API web del estándar DOM, no una característica del lenguaje ECMAScript.
Ejemplos
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));Resultado
true true true false false false
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.