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

CKTIS / JavaScript

Node.replaceChild — reemplazar un hijo

Node.replaceChild reemplaza un hijo directo de un padre y devuelve el nodo eliminado. El nodo de reemplazo se proporciona como primer argumento.

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

const removedNode = parent.replaceChild(newChild, oldChild);

parent.replaceChild(newChild, oldChild) reemplaza oldChild por newChild y devuelve oldChild. Los argumentos deben ser nodos, no cadenas de texto. Es una API del DOM, no una característica de ECMAScript.

Si newChild ya existe, se mueve, no se copia. Un DocumentFragment inserta sus hijos en lugar del fragmento en sí.

Una estructura no válida, como un ciclo, puede provocar HierarchyRequestError. El método comprueba si el reemplazo crearía un ciclo antes de comprobar si oldChild es un hijo directo de parent. Si las comprobaciones anteriores no detectan ningún error y oldChild no es un hijo directo de parent, el método lanza NotFoundError.

Ejemplos

const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);

const removedNode = parent.replaceChild(newChild, oldChild);

console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);

Resultado

new
true
true

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