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.