Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori