CKTIS / JavaScript
Element.remove(): desligar um elemento
O método element.remove() desliga um elemento do respetivo elemento-pai. Não aceita argumentos, devolve undefined e não faz nada se o elemento não tiver um elemento-pai.
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
element.remove()Element.remove designa o método de instância element.remove(), disponibilizado pelo mixin ChildNode. É uma API do DOM, não uma função definida pelo ECMAScript.
O método desliga o elemento e a respetiva subárvore do elemento-pai. Uma referência guardada continua a apontar para o mesmo objeto, que pode ser inserido novamente. Se não houver elemento-pai, a chamada não faz nada.
Ao contrário de parent.removeChild(element), este método não precisa de uma referência ao elemento-pai e devolve undefined, não o nó removido. O exemplo usa uma árvore desligada: o elemento não tem de pertencer ao documento.
Exemplos
const parent = document.createElement('div');
const element = document.createElement('span');
parent.appendChild(element);
console.log(parent.childNodes.length);
const result = element.remove();
console.log(parent.childNodes.length);
console.log(element.parentNode === null);
console.log(result === undefined);
element.remove();
console.log(parent.childNodes.length);Resultado
1 0 true true 0
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.