CKTIS / JavaScript
Node.removeChild(): odłączanie węzła potomnego
Metoda parent.removeChild(child) odłącza bezpośrednie dziecko od rodzica i zwraca ten sam węzeł, który można ponownie wstawić.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
parent.removeChild(child)Node.removeChild to metoda instancji interfejsu Node, zdefiniowana w standardzie DOM, nie w ECMAScript. Wywołaj parent.removeChild(child) na rodzicu; child może być także węzłem tekstowym.
Metoda zwraca ten sam obiekt child. Po odłączeniu jego parentNode wynosi null; zachowany węzeł można ponownie wstawić przez appendChild. Odłączenie nie oznacza zniszczenia obiektu ani jego poddrzewa.
Jeśli child jest węzłem (Node), ale nie jest bezpośrednim dzieckiem parent, metoda zgłasza DOMException o nazwie NotFoundError. Dotyczy to na przykład dalszego potomka lub ponownej próby usunięcia już odłączonego dziecka. Przekazanie null powoduje zgłoszenie TypeError podczas konwersji argumentu zgodnie z regułami Web IDL, jeszcze przed sprawdzeniem rodzica węzła. Przykład wymaga przeglądarkowego DOM; sama wersja Node.js nie dowodzi dostępności tego API.
Przykłady
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);Wynik
true true 0 Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.