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.