CKTIS / JavaScript
Element.remove(): desvincular un elemento
El método element.remove() desvincula un elemento de su elemento padre. No acepta argumentos, devuelve undefined y no hace nada si el elemento no tiene padre.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.remove()Element.remove se refiere al método de instancia element.remove(), proporcionado por el mixin ChildNode. Es una API del DOM, no una función definida por ECMAScript.
El método desvincula el elemento y su subárbol de su elemento padre. Una referencia que se conserve sigue apuntando al mismo objeto; se puede insertar de nuevo. Si no tiene padre, la llamada no hace nada.
A diferencia de parent.removeChild(element), este método no necesita una referencia al padre y devuelve undefined, no el nodo eliminado. El ejemplo utiliza un árbol desvinculado: el elemento no tiene que pertenecer al documento.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.