CKTIS / JavaScript
Node.contains() y Node.isConnected: subárbol o documento
Usa `contains()` para comprobar si un nodo pertenece a un subárbol concreto e `isConnected` para saber si está conectado a un documento.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
container.contains(otherNode) // boolean; otherNode is a required argument that accepts a Node or null
node.isConnected // boolean; read-only propertycontainer.contains(otherNode) devuelve true si otherNode es el propio container o uno de sus descendientes directos o indirectos en el árbol de nodos. También funciona en un subárbol separado del documento. El argumento es obligatorio: null da false, pero omitirlo o pasar un selector como cadena provoca un TypeError.
node.isConnected es una propiedad booleana de solo lectura, no un método. Vale true si la raíz del nodo, tras seguir los anfitriones de Shadow DOM que haya en el camino, es un Document. No tiene por qué ser el document actual, y el resultado no indica si el nodo es visible. Al separar un subárbol de un documento, isConnected pasa a false para sus nodos sin alterar las relaciones dentro del subárbol.
contains() no cruza los límites de Shadow DOM. Un nodo de un árbol de sombra puede tener isConnected === true si su anfitrión está conectado a un documento, aunque host.contains(shadowChild) devuelva false. Ambas son API del DOM web, no funciones de ECMAScript 2024; su disponibilidad depende del entorno de ejecución.
Ejemplos
<!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>Resultado
self/null: true false before: true false attached: true true shadow: false true true detached: true false
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba la salida en la consola de desarrollo. Crea un documento HTML aparte sin modificar la página abierta. Tras retirar el anfitrión, `child` sigue dentro de él, pero `child.isConnected` vuelve a ser `false`.
Lecciones relacionadas
- JavaScript · Lección 40 · Intermedio · Versión: 3