CKTIS / JavaScript
Element.replaceWith — reemplazar un elemento
Element.replaceWith reemplaza un elemento dentro de su padre por nodos y texto. Las cadenas se convierten en texto, no en marcado HTML.
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.replaceWith(...nodes)Element.replaceWith procede del mixin ChildNode del estándar DOM, no de una edición de ECMAScript. La llamada element.replaceWith(...nodes) reemplaza el propio elemento, no sus hijos; replaceChildren(...nodes) modifica los hijos.
Los argumentos son nodos y cadenas, en el orden indicado. Los nodos se mueven, no se copian; las cadenas crean nodos Text sin analizar HTML. El método devuelve undefined. Si se llama sin argumentos, elimina el elemento; si este no tiene padre, no se realizan cambios.
Una estructura de árbol no válida puede provocar HierarchyRequestError. Comprueba la disponibilidad con typeof Element.prototype.replaceWith === 'function' en un entorno DOM; la versión de Node.js por sí sola no demuestra que haya compatibilidad.
Ejemplos
const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);
const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');
console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);Resultado
new <text> true 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.