CKTIS / JavaScript
Element.replaceWith — nahradenie elementu
Element.replaceWith nahradí element v jeho rodičovi uzlami a textom. Reťazce sa zmenia na text, nie na značkovací kód HTML.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.replaceWith(...nodes)Element.replaceWith pochádza z mixinu ChildNode v štandarde DOM, nie z niektorej edície ECMAScriptu. Volanie element.replaceWith(...nodes) nahradí samotný element, nie jeho potomkov; replaceChildren(...nodes) mení potomkov.
Argumentmi sú uzly a reťazce v uvedenom poradí. Uzly sa presúvajú, nekopírujú; reťazce vytvárajú uzly Text bez spracovania HTML kódu. Metóda vracia undefined. Volanie bez argumentov element odstráni; ak nemá rodiča, nič nezmení.
Neplatná štruktúra stromu môže spôsobiť HierarchyRequestError. Dostupnosť overte v prostredí DOM pomocou typeof Element.prototype.replaceWith === 'function'; samotná verzia Node.js nepotvrdzuje, že je funkcia podporovaná.
Prí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ýsledok
new <text> true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.