CKTIS / JavaScript
ShadowRoot — la raíz de un árbol Shadow DOM
ShadowRoot representa la raíz de un árbol Shadow DOM asociado a un elemento anfitrión. Permite acceder a la estructura interna de un componente. Los modos open y closed difieren en el acceso mediante host.shadowRoot, pero ninguno crea un límite de seguridad.
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
const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));ShadowRoot es la raíz de un árbol Shadow DOM, un DocumentFragment especializado asociado a un elemento anfitrión. Sus nodos internos forman un árbol separado: host.querySelector() no los busca, mientras que root.querySelector() busca dentro de él. La propiedad root.host identifica al anfitrión.
Crea una raíz con host.attachShadow({ mode: "open" }), no con new ShadowRoot(). El método devuelve la raíz; con open, host.shadowRoot también permite acceder a ella. Con closed, esa propiedad devuelve null, pero una referencia conservada sigue funcionando. closed restringe el acceso mediante esa propiedad, pero no protege frente a código no confiable.
Shadow DOM permite encapsular componentes, pero no es un documento independiente ni ofrece aislamiento completo de estilos: la herencia CSS sigue siendo relevante. Un elemento slot puede mostrar los hijos del anfitrión sin trasladarlos al árbol shadow. No hace falta registrar un elemento personalizado para usar Shadow DOM en un anfitrión compatible, como div.
Esta es una API de la plataforma web, no una característica de una edición concreta de ECMAScript. Que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad en el navegador. El ejemplo requiere un navegador con attachShadow y compara ambos modos sin modificar la página.
Ejemplos
(() => {
const host = document.createElement("div");
const root = host.attachShadow({ mode: "open" });
const label = document.createElement("span");
label.textContent = "Hello";
root.append(label);
console.log(root instanceof ShadowRoot);
console.log(host.shadowRoot === root);
console.log(root.host === host);
console.log(root.querySelector("span").textContent);
console.log(host.querySelector("span") === null);
const closedHost = document.createElement("div");
const closedRoot = closedHost.attachShadow({ mode: "closed" });
console.log(closedHost.shadowRoot === null);
console.log(closedRoot.host === closedHost);
})();Resultado
true true true Hello true true true
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.