Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła