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

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.

Fontes