Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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 property

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

Fuentes