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

CKTIS / JavaScript

Element.replaceChildren() — nahrazení všech potomků

Element.replaceChildren() nahradí potomky elementu uzly a řetězci předanými jako argumenty. Při volání bez argumentů odstraní všechny potomky.

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.replaceChildren(...nodes)

Element.replaceChildren pochází z mixinu ParentNode standardu DOM, nikoli z ECMAScriptu. Nahradí všechny potomky elementu a samotný element ponechá beze změny. Vrací undefined.

Argumenty jsou uzly nebo řetězce a zpracovávají se v zadaném pořadí. Řetězce se změní na uzly Text, neparsují se jako HTML. Existující uzly se přesunou, neklonují. Při opětovném předání téhož uzlu se uzel přesune, místo aby se přidal další potomek. Pokud jsou a a b různé elementy, po volání element.replaceChildren(a, b, a) zůstanou b a a v tomto pořadí. element.replaceChildren() odstraní všechny potomky.

Neplatná hierarchie, například vložení elementu do něj samotného, vyvolá DOMException s názvem HierarchyRequestError.

Jde o API DOM v prohlížeči; přítomnost Node 24 nedokazuje, že je dostupné. V cílovém prostředí ověřte typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Příklady

const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';

box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);

box.replaceChildren();
console.log(box.childNodes.length);

Výsledek

Status: New
2
true
0

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