CKTIS / JavaScript
Element.replaceWith — nahrazení elementu
Element.replaceWith nahradí element v jeho rodiči uzly a textem. Řetězce se převedou na text, nikoli na značkovací kód HTML.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.replaceWith(...nodes)Element.replaceWith pochází z mixinu ChildNode ve standardu DOM, nikoli z některé edice ECMAScriptu. Volání element.replaceWith(...nodes) nahradí samotný element, ne jeho potomky; replaceChildren(...nodes) mění potomky.
Argumenty jsou uzly a řetězce v uvedeném pořadí. Uzly se přesouvají, nekopírují; řetězce vytvářejí uzly Text, aniž by se zpracovával HTML kód. Metoda vrací undefined. Volání bez argumentů element odstraní; pokud nemá rodiče, nic nezmění.
Neplatná struktura stromu může způsobit HierarchyRequestError. Dostupnost ověřte v prostředí DOM pomocí typeof Element.prototype.replaceWith === 'function'; samotná verze Node.js nepotvrzuje, že je funkce podporována.
Příklady
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);Výsledek
new <text> true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.