CKTIS / JavaScript
Node.removeChild(): odpojenie podradeného uzla
Metóda parent.removeChild(child) odpojí priameho potomka od jeho rodiča a vráti ten istý uzol, ktorý možno znova vložiť.
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
parent.removeChild(child)Node.removeChild je inštančná metóda rozhrania Node, definovaná štandardom DOM, nie jazykom ECMAScript. Zavolajte parent.removeChild(child) na rodičovi; child môže byť aj textový uzol.
Metóda vráti ten istý objekt child. Po odpojení má jeho parentNode hodnotu null; zachovaný uzol možno znova vložiť pomocou appendChild. Odpojením sa nezničí objekt ani jeho podstrom.
Ak je child uzol typu Node, ale nie je priamym potomkom uzla parent, metóda vyvolá DOMException s názvom NotFoundError. Stane sa to napríklad pri odovzdaní vzdialenejšieho potomka alebo pri opakovanom pokuse odstrániť už odpojeného potomka. Odovzdanie null vyvolá TypeError pri konverzii argumentu podľa pravidiel Web IDL, ešte pred kontrolou rodičovského uzla. Príklad vyžaduje DOM v prehliadači; samotná verzia Node.js nedokazuje dostupnosť tohto API.
Prí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ýsledok
true true 0 Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.