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

CKTIS / JavaScript

Element.replaceChildren() — nahradenie všetkých potomkov

Element.replaceChildren() nahradí potomkov elementu uzlami a reťazcami zadanými ako argumenty. Pri volaní bez argumentov odstráni všetkých potomkov.

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

Element.replaceChildren pochádza z mixinu ParentNode štandardu DOM, nie z ECMAScriptu. Nahradí všetkých potomkov elementu a samotný element ponechá nezmenený. Vráti undefined.

Argumentmi sú uzly alebo reťazce, ktoré sa spracujú v zadanom poradí. Reťazce sa zmenia na uzly Text, neinterpretujú sa ako HTML. Existujúce uzly sa presúvajú, neklonujú sa. Pri opätovnom zadaní toho istého uzla sa uzol presunie, namiesto toho, aby pribudol ďalší potomok. Ak sú a a b rôzne elementy, po volaní element.replaceChildren(a, b, a) zostanú b a a v tomto poradí. element.replaceChildren() odstráni všetkých potomkov.

Neplatná hierarchia, napríklad vloženie elementu do seba samého, vyvolá DOMException s názvom HierarchyRequestError.

Ide o API DOM v prehliadači; prítomnosť Node 24 nedokazuje, že je dostupné. V cieľovom prostredí skontrolujte typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Prí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ýsledok

Status: New
2
true
0

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje