Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes