Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori