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.