CKTIS / JavaScript
Node.removeChild(): odpojení podřízeného uzlu
Metoda parent.removeChild(child) odpojí přímého potomka od jeho rodiče a vrátí tentýž uzel, který lze znovu vložit.
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
parent.removeChild(child)Node.removeChild je instanční metoda rozhraní Node, definovaná standardem DOM, nikoli ECMAScriptem. Zavolejte parent.removeChild(child) na rodiči; child může být také textový uzel.
Metoda vrátí tentýž objekt child. Po odpojení má jeho parentNode hodnotu null; zachovaný uzel lze znovu vložit pomocí appendChild. Odpojením se nezničí objekt ani jeho podstrom.
Pokud je child uzel typu Node, ale není přímým potomkem uzlu parent, metoda vyvolá DOMException s názvem NotFoundError. K tomu dojde například při předání vzdálenějšího potomka nebo při opakovaném pokusu odstranit již odpojeného potomka. Předání null vyvolá TypeError při převodu argumentu podle pravidel Web IDL, ještě před kontrolou rodičovského uzlu. Příklad vyžaduje DOM v prohlížeči; samotná verze Node.js nedokládá dostupnost tohoto API.
Příklady
const parent = document.createElement('div');
const child = document.createTextNode('Hello');
parent.appendChild(child);
const removed = parent.removeChild(child);
console.log(removed === child);
console.log(child.parentNode === null);
console.log(parent.childNodes.length);
parent.appendChild(removed);
console.log(parent.textContent);Výsledek
true true 0 Hello
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.