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

CKTIS / JavaScript

ShadowRoot.append — añadir nodos y texto a un árbol shadow

ShadowRoot.append añade nodos y texto al final de un árbol shadow. Se hereda de DocumentFragment, en lugar de ser una implementación independiente. Aprende cómo se mueven los nodos, cómo queda vacío un fragmento y en qué se diferencia de appendChild().

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

shadowRoot.append(...nodesOrStrings);
fragment.append(...nodesOrStrings);

ShadowRoot.append es el método heredado DocumentFragment.append: ShadowRoot hereda de DocumentFragment. Al llamar a root.append(...), el contenido se añade después del último hijo de la raíz shadow, no a los hijos normales del elemento anfitrión. En cambio, un fragmento normal sirve para construir un subárbol antes de insertarlo en su destino.

El método acepta varios nodos y cadenas, en el orden de los argumentos. Las cadenas se convierten en nodos Text; no se analizan como HTML. Un nodo existente se mueve, no se copia. Al pasar un DocumentFragment normal, se mueven sus hijos y el fragmento queda vacío; el fragmento en sí no pasa a ser hijo de la raíz.

El resultado es undefined. A diferencia de append(), appendChild() acepta un solo nodo, no admite directamente cadenas como argumentos y devuelve el nodo añadido o el fragmento vaciado. Una inserción no válida, por ejemplo, una que cree un ciclo, puede lanzar una DOMException HierarchyRequestError.

Esta es una API del DOM, no una característica de una edición concreta de ECMAScript. MDN indica que DocumentFragment.append() está ampliamente disponible en los navegadores desde abril de 2018; su uso en una raíz shadow también requiere compatibilidad con Shadow DOM. La presencia de Node 24 en un repositorio no demuestra por sí sola que estas API del navegador sean compatibles.

Ejemplos

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const fragment = document.createDocumentFragment();
  const label = document.createElement("strong");
  label.textContent = "DOM";

  fragment.append("Hello ", label);
  const result = root.append(fragment, "!");

  console.log(root.textContent);
  console.log(root.childNodes.length);
  console.log(fragment.childNodes.length);
  console.log(label.parentNode === root);
  console.log(host.childNodes.length);
  console.log(result === undefined);
})();

Resultado

Hello DOM!
3
0
true
0
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.

Fuentes