CKTIS / JavaScript
Node.appendChild — acrescentar um nó
Node.appendChild acrescenta um nó como último filho de um elemento-pai. Devolve o nó fornecido e move um nó existente em vez de o copiar.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
parent.appendChild(node)parent.appendChild(node) aceita um único Node e devolve esse mesmo objeto. É uma API do DOM, não uma função ECMAScript.
Se node já tiver um elemento-pai, é movido, não copiado. Acrescentar novamente um filho existente move-o para o fim. Com um DocumentFragment, os respetivos filhos são movidos pela ordem que já tinham; o fragmento devolvido fica vazio.
Uma hierarquia inválida, como inserir um antepassado num dos seus descendentes, causa um HierarchyRequestError. Ao contrário de append(), este método não aceita texto nem vários argumentos como lista de nós.
O exemplo requer o DOM de um navegador; uma versão de Node.js, por si só, não comprova o suporte desta API. O resultado BA demonstra a deslocação de first.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.