Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła