CKTIS / JavaScript
Element.replaceChildren() — reemplazar todos los nodos hijos
Element.replaceChildren() sustituye los nodos hijos de un elemento por los nodos y las cadenas que se pasan como argumentos. Si se llama sin argumentos, elimina todos los nodos hijos.
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.replaceChildren(...nodes)Element.replaceChildren procede del mixin ParentNode del estándar DOM, no de ECMAScript. Sustituye todos los nodos hijos de un elemento, incluidos los nodos de texto, y deja intacto el elemento en sí. Devuelve undefined.
Los argumentos son nodos o cadenas y se procesan en el orden indicado. Las cadenas se convierten en nodos Text; no se analizan como HTML. Los nodos existentes se mueven, no se clonan. Si se pasa de nuevo el mismo nodo, este se mueve en vez de añadirse otro hijo. Si a y b son elementos distintos, tras element.replaceChildren(a, b, a) quedan b y a, en ese orden. element.replaceChildren() elimina todos los nodos hijos.
Una jerarquía no válida, como insertar un elemento dentro de sí mismo, lanza una DOMException cuyo nombre es HierarchyRequestError.
Esta es una API del DOM de los navegadores; tener Node 24 no demuestra que esté disponible. Comprueba typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function' en el entorno de destino.
Ejemplos
const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';
box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);
box.replaceChildren();
console.log(box.childNodes.length);Resultado
Status: New 2 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.