Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.replaceChildren() — zamenjava vseh podrejenih vozlišč

Element.replaceChildren() zamenja podrejena vozlišča elementa z vozlišči in nizi, podanimi kot argumenti. Če jo pokličete brez argumentov, odstrani vsa podrejena vozlišča.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.replaceChildren(...nodes)

Element.replaceChildren izhaja iz mixina ParentNode standarda DOM, ne iz ECMAScripta. Zamenja vsa podrejena vozlišča elementa, sam element pa ostane nespremenjen. Vrne undefined.

Argumenti so vozlišča ali nizi, ki se obdelajo v podanem vrstnem redu. Nizi postanejo vozlišča Text; ne razčlenijo se kot HTML. Obstoječa vozlišča se premaknejo, ne klonirajo. Če isto vozlišče podate znova, se premakne, namesto da bi se dodalo še eno podrejeno vozlišče. Če sta a in b različna elementa, po klicu element.replaceChildren(a, b, a) ostaneta b in nato a. element.replaceChildren() odstrani vsa podrejena vozlišča.

Neveljavna hierarhija, na primer vstavljanje elementa vase, sproži DOMException z imenom HierarchyRequestError.

To je API DOM v brskalniku; prisotnost Node 24 ne dokazuje, da je API na voljo. V ciljnem okolju preverite typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.

Primeri

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);

Rezultat

Status: New
2
true
0

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri