Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes