Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje