CKTIS / JavaScript
Element.append — añadir nodos y texto
`Element.append` añade nodos y texto al final de un elemento y devuelve `undefined`. Si `a` y `b` son elementos distintos, tras una llamada a `element.append(a, b, a)` que termina sin errores, al final queda `b` seguido de `a`: la última aparición de `a` mueve el nodo en vez de copiarlo. En cambio, si `a` es un `DocumentFragment` que contiene un único nodo de texto y `b` es un elemento separado, la primera aparición de `a` coloca el nodo de texto antes de `b` y vacía el fragmento. La última aparición no añade nada y el fragmento en sí no se inserta.
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
element.append(...nodes)Element.append procede del mixin ParentNode del estándar DOM, no de ECMAScript. Añade cero o más argumentos después del último hijo del elemento.
Las cadenas se convierten en nodos Text, no en marcado HTML. Un nodo existente se mueve, no se copia. Un DocumentFragment aporta sus hijos y queda vacío.
A diferencia de appendChild, append acepta varios argumentos, incluido texto, y devuelve undefined. Una jerarquía no válida, como insertar un elemento dentro de sí mismo, provoca HierarchyRequestError.
Ejemplos
const box = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'OK';
const result = box.append('Status: ', label, '!');
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(result);Resultado
Status: OK! 3 undefined
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.