CKTIS / JavaScript
Node.replaceChild — zamjena djeteta
Node.replaceChild zamjenjuje izravno dijete roditelja i vraća uklonjeni čvor. Zamjenski čvor navodi se kao prvi argument.
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
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) zamjenjuje oldChild s newChild i vraća oldChild. Argumenti moraju biti čvorovi, a ne nizovi znakova. To je DOM API, a ne značajka ECMAScripta.
Ako newChild već postoji, premješta se, a ne kopira. DocumentFragment umeće svoju djecu umjesto samog fragmenta.
Nevaljana struktura, primjerice ciklus, može uzrokovati HierarchyRequestError. Metoda provjerava bi li zamjenom nastao ciklus prije nego što provjeri je li oldChild izravno dijete čvora parent. Ako prethodne provjere ne otkriju pogrešku, a oldChild nije izravno dijete čvora parent, metoda baca iznimku NotFoundError.
Primjeri
const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);
const removedNode = parent.replaceChild(newChild, oldChild);
console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);Rezultat
new true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.