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

CKTIS / JavaScript

Node.removeChild(): separar un nodo hijo

El método parent.removeChild(child) separa un hijo directo de su padre y devuelve el mismo nodo, que se puede insertar de nuevo.

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

parent.removeChild(child)

Node.removeChild es un método de instancia de la interfaz Node, definido por el estándar DOM, no por ECMAScript. Llama a parent.removeChild(child) en el padre; child también puede ser un nodo de texto.

El método devuelve el mismo objeto child. Después de separarlo, su parentNode es null; el nodo conservado se puede volver a insertar mediante appendChild. Separarlo no destruye el objeto ni su subárbol.

Si child es un Node pero no es un hijo directo de parent, el método lanza una DOMException llamada NotFoundError. Esto ocurre, por ejemplo, si se pasa un descendiente más lejano o se intenta eliminar de nuevo un hijo ya separado. Si se pasa null, se lanza un TypeError durante la conversión del argumento según las reglas de Web IDL, antes de comprobar el padre del nodo. El ejemplo requiere un DOM de navegador; una versión de Node.js por sí sola no demuestra que la API esté disponible.

Ejemplos

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

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