Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Node.appendChild — aggiungere un nodo

Node.appendChild aggiunge un nodo come ultimo figlio di un genitore. Restituisce il nodo fornito e sposta un nodo già esistente invece di copiarlo.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

parent.appendChild(node)

parent.appendChild(node) accetta un solo Node e restituisce lo stesso oggetto. È un’API DOM, non una funzione ECMAScript.

Se node ha già un genitore, viene spostato, non copiato. Aggiungere di nuovo un figlio esistente lo sposta alla fine. Con un DocumentFragment, i suoi figli vengono spostati mantenendo l’ordine attuale; il frammento restituito diventa vuoto.

Una gerarchia non valida, ad esempio inserire un antenato in un suo discendente, causa un HierarchyRequestError. A differenza di append(), questo metodo non accetta né testo né più argomenti come lista di nodi.

L’esempio richiede il DOM di un browser; una versione Node.js da sola non dimostra il supporto per questa API. Il risultato BA mostra lo spostamento di first.

Esempi

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);

Risultato

BA
true
2

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti