CKTIS / JavaScript
Node.replaceChild — nahrazení potomka
Node.replaceChild nahradí přímého potomka rodiče a vrátí odebraný uzel. Nahrazující uzel se předává jako první argument.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const removedNode = parent.replaceChild(newChild, oldChild);parent.replaceChild(newChild, oldChild) nahradí oldChild uzlem newChild a vrátí oldChild. Argumenty musí být uzly, nikoli řetězce. Jde o DOM API, nikoli o funkci ECMAScriptu.
Již existující newChild se přesune, nezkopíruje. DocumentFragment vloží své potomky, nikoli samotný fragment.
Neplatná struktura, například cyklus, může vyvolat HierarchyRequestError. Metoda nejprve ověří, zda by nahrazením vznikl cyklus, a teprve potom zjišťuje, zda je oldChild přímým potomkem uzlu parent. Pokud předchozí kontroly neodhalí chybu a oldChild není přímým potomkem uzlu parent, metoda vyvolá NotFoundError.
Pří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ýsledek
new true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.