CKTIS / JavaScript
`contains()` y `parentElement`: descendientes y padres directos en el DOM
`contains()` comprueba si un nodo es el mismo nodo o uno de sus descendientes. `parentElement` devuelve el padre directo solo si es un elemento.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
container.contains(otherNode) // boolean; pass a Node or null
node.parentElement // Element or null; read-onlycontainer.contains(otherNode) devuelve true si otherNode es el propio container o un descendiente a cualquier profundidad, incluido un nodo de texto. Si se pasa null, devuelve false. Omitir el argumento obligatorio o pasar una cadena provoca un TypeError. Para excluir al propio container, usa otherNode !== container && container.contains(otherNode).
node.parentElement es una propiedad de solo lectura, no un método. Devuelve el padre directo si es un Element. Devuelve null si no hay padre o si es de otro tipo, como Document o DocumentFragment. No busca más arriba en el árbol. Usa node.parentNode para obtener el padre directo, sea cual sea su tipo.
Ambas consultas reflejan la estructura actual del árbol, incluso si está separado del documento. Mover un nodo puede cambiar el resultado. Ninguna pasa de un árbol shadow a su elemento anfitrión: según contains(), el anfitrión no contiene sus nodos del árbol shadow, y el parentElement de un hijo directo de un ShadowRoot es null.
Ambos miembros pertenecen a la interfaz Node del DOM y no al lenguaje ECMAScript 2024. Su disponibilidad depende de si el entorno de ejecución proporciona las API del DOM correspondientes.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>Node.contains() and Node.parentElement</title>
<script>
const fragment = document.createDocumentFragment();
const section = document.createElement("section");
const span = document.createElement("span");
const text = document.createTextNode("Hello");
fragment.appendChild(section);
section.appendChild(span);
span.appendChild(text);
console.log(`section.contains(text): ${section.contains(text)}`);
console.log(`section.contains(section): ${section.contains(section)}`);
console.log(`section.contains(null): ${section.contains(null)}`);
console.log(`text.parentElement === span: ${text.parentElement === span}`);
console.log(`section.parentElement: ${section.parentElement}`);
console.log(`section.parentNode === fragment: ${section.parentNode === fragment}`);
</script>Resultado
section.contains(text): true section.contains(section): true section.contains(null): false text.parentElement === span: true section.parentElement: null section.parentNode === fragment: true
Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y comprueba la salida en la consola de desarrollo. El fragmento separado del documento contiene `section`, pero no es un `Element`. Por eso `section.parentElement` vale `null`, aunque `section.parentNode` sea el fragmento.
Lecciones relacionadas
- JavaScript · Lección 18 · Avanzado · Versión: 4