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

CKTIS / JavaScript

Node.appendChild — añadir un nodo

Node.appendChild añade un nodo como último hijo de un padre. Devuelve el nodo proporcionado y mueve un nodo existente en vez de copiarlo.

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

parent.appendChild(node)

parent.appendChild(node) acepta un único Node y devuelve ese mismo objeto. Es una API del DOM, no una función de ECMAScript.

Si node ya tiene padre, se mueve, no se copia. Al añadir de nuevo un hijo existente, este pasa al final. Con un DocumentFragment, sus hijos se mueven en el orden que ya tenían; el fragmento devuelto queda vacío.

Una jerarquía no válida, como insertar un antepasado en uno de sus descendientes, provoca un HierarchyRequestError. A diferencia de append(), este método no acepta texto ni varios argumentos como lista de nodos.

El ejemplo requiere el DOM de un navegador; una versión de Node.js por sí sola no demuestra que la API esté disponible. El resultado BA muestra que first se mueve.

Ejemplos

const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const second = document.createElement('span');
second.textContent = 'B';

parent.appendChild(first);
parent.appendChild(second);
const returned = parent.appendChild(first);

console.log(parent.textContent);
console.log(returned === first);
console.log(parent.childNodes.length);

Resultado

BA
true
2

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