CKTIS / JavaScript
Element.remove(): odłączanie elementu
Metoda element.remove() odłącza element od rodzica. Nie przyjmuje argumentów, zwraca undefined i niczego nie zmienia, jeśli element nie ma rodzica.
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
element.remove()Element.remove oznacza metodę instancji element.remove(), udostępnianą przez domieszkę ChildNode. Jest to API DOM, a nie funkcja zdefiniowana przez ECMAScript.
Metoda odłącza element wraz z jego poddrzewem od rodzica. Zachowana referencja nadal wskazuje ten sam obiekt; można go ponownie wstawić. Bez rodzica wywołanie niczego nie zmienia.
W przeciwieństwie do parent.removeChild(element) metoda nie wymaga wskazania rodzica i zwraca undefined, nie usunięty węzeł. Przykład działa na odłączonym drzewie: element nie musi należeć do dokumentu.
Przykłady
const parent = document.createElement('div');
const element = document.createElement('span');
parent.appendChild(element);
console.log(parent.childNodes.length);
const result = element.remove();
console.log(parent.childNodes.length);
console.log(element.parentNode === null);
console.log(result === undefined);
element.remove();
console.log(parent.childNodes.length);Wynik
1 0 true true 0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.