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.