CKTIS / JavaScript
Node.replaceChild — nahradenie potomka
Node.replaceChild nahradí priameho potomka rodiča a vráti odstránený uzol. Náhradný uzol sa zadáva ako prvý argument.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) nahradí oldChild uzlom newChild a vráti oldChild. Argumenty musia byť uzly, nie reťazce. Ide o DOM API, nie o funkciu ECMAScriptu.
Už existujúci newChild sa presunie, nie skopíruje. DocumentFragment vloží svoje deti, nie samotný fragment.
Neplatná štruktúra, napríklad cyklus, môže vyvolať HierarchyRequestError. Metóda overí, či by nahradením vznikol cyklus, skôr než overí, či je oldChild priamym potomkom uzla parent. Ak predchádzajúce kontroly neodhalia chybu a oldChild nie je priamym potomkom uzla parent, metóda vyvolá NotFoundError.
Príklady
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);Výsledok
new true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.