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

CKTIS / JavaScript

Node.removeChild(): desligar um nó filho

O método parent.removeChild(child) desliga um filho direto do respetivo pai e devolve o mesmo nó, que pode ser inserido novamente.

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.removeChild(child)

Node.removeChild é um método de instância da interface Node, definido pela norma DOM, e não por ECMAScript. Chama parent.removeChild(child) no pai; child também pode ser um nó de texto.

O método devolve o mesmo objeto child. Depois de desligado, o seu parentNode é null; o nó mantido pode ser inserido novamente com appendChild. O desligamento não destrói o objeto nem a sua subárvore.

Se child for um Node, mas não for um filho direto de parent, o método lança uma DOMException com o nome NotFoundError. É o que acontece, por exemplo, quando se passa um descendente mais afastado ou se tenta remover novamente um filho já desligado. Se for passado null, é lançado um TypeError durante a conversão do argumento segundo as regras de Web IDL, antes da verificação do nó pai. O exemplo requer um DOM de navegador; uma versão de Node.js, por si só, não comprova que esta API esteja disponível.

Exemplos

const parent = document.createElement('div');
const child = document.createTextNode('Hello');
parent.appendChild(child);

const removed = parent.removeChild(child);
console.log(removed === child);
console.log(child.parentNode === null);
console.log(parent.childNodes.length);

parent.appendChild(removed);
console.log(parent.textContent);

Resultado

true
true
0
Hello

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