CKTIS / JavaScript
Node.replaceChild — zamenjava otroka
Node.replaceChild zamenja neposrednega otroka nadrejenega vozlišča in vrne odstranjeno vozlišče. Nadomestno vozlišče je prvi argument.
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
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) zamenja oldChild z newChild in vrne oldChild. Argumenti morajo biti vozlišča, ne nizi. To je API DOM, ne funkcija ECMAScripta.
Če newChild že obstaja, se premakne in ne kopira. DocumentFragment vstavi svoje otroke namesto fragmenta samega.
Neveljavna struktura, na primer cikel, lahko sproži HierarchyRequestError. Metoda preveri, ali bi zamenjava ustvarila cikel, preden preveri, ali je oldChild neposreden otrok vozlišča parent. Če predhodna preverjanja ne odkrijejo napake in oldChild ni neposreden otrok vozlišča parent, metoda sproži NotFoundError.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.