Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje