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

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.

Zdroje