Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri