CKTIS / JavaScript
Element.replaceChildren() — zamjena svih podređenih čvorova
Element.replaceChildren() zamjenjuje podređene čvorove elementa čvorovima i nizovima znakova navedenima kao argumenti. Poziv bez argumenata uklanja sve podređene čvorove.
Verzija: 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 potječe iz mixina ParentNode standarda DOM, a ne iz ECMAScripta. Zamjenjuje sve podređene čvorove elementa, dok sam element ostaje nepromijenjen. Vraća undefined.
Argumenti su čvorovi ili nizovi znakova, a obrađuju se zadanim redoslijedom. Nizovi znakova postaju čvorovi Text; ne tumače se kao HTML. Postojeći čvorovi premještaju se, a ne kloniraju. Ako se isti čvor ponovno navede kao argument, on se premješta umjesto da se doda još jedan podređeni čvor. Ako su a i b različiti elementi, nakon poziva element.replaceChildren(a, b, a) ostaju b pa a. element.replaceChildren() uklanja sve podređene čvorove.
Nevaljana hijerarhija, primjerice umetanje elementa u njega samog, pokreće DOMException naziva HierarchyRequestError.
Ovo je API DOM-a u pregledniku; činjenica da je Node 24 dostupan ne dokazuje da je ovaj API dostupan. U ciljnom okruženju provjerite typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.