CKTIS / JavaScript
Element.attachShadow — adjuntar un árbol Shadow DOM
Element.attachShadow() adjunta una raíz Shadow DOM a un elemento compatible y devuelve un ShadowRoot. El modo obligatorio, open o closed, controla el acceso mediante host.shadowRoot, pero no constituye una barrera 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 = element.attachShadow({ mode: "open" });Element.attachShadow() crea un árbol Shadow DOM asociado a un elemento anfitrión y devuelve su ShadowRoot. Es un árbol independiente: sus nodos no se convierten en hijos normales del anfitrión. Por eso, host.querySelector() no busca en su interior; llama al método sobre la raíz devuelta.
La opción mode es obligatoria. Con "open", host.shadowRoot expone la raíz; con "closed", devuelve null. En ambos modos, attachShadow() devuelve la raíz, así que una referencia conservada permite seguir modificándola. "closed" no protege los datos confidenciales.
No todos los elementos pueden ser anfitriones: div es compatible, pero input, por ejemplo, no lo es. Un anfitrión no compatible o volver a adjuntar una raíz normal ya existente provoca NotSupportedError. Una raíz declarativa existente es una excepción: un mode coincidente permite reutilizarla, pero borra su contenido; un modo distinto provoca un error.
Esta es una API DOM del navegador, no una característica de una edición concreta de ECMAScript. Comprueba typeof Element.prototype.attachShadow === "function" en el navegador de destino; esta comprobación no demuestra que se admitan todas las opciones adicionales. La presencia de Node 24 en el repositorio no demuestra que esta API sea compatible.
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(host.shadowRoot === root);
console.log(host.querySelector("span") === null);
console.log(root.querySelector("span").textContent);
})();Resultado
true true Hello
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.