Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje