Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje