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

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.

Fuentes