KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Element.remove(): een element loskoppelen

De methode element.remove() koppelt een element los van het bovenliggende element. De methode neemt geen argumenten aan, retourneert undefined en doet niets als het element geen bovenliggend element heeft.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.remove()

Element.remove verwijst naar de instantiemethode element.remove(), die via de ChildNode-mixin beschikbaar wordt gemaakt. Het is een DOM-API, geen functie die door ECMAScript is gedefinieerd.

De methode koppelt het element en de bijbehorende subboom los van het bovenliggende element. Een bewaarde verwijzing wijst nog steeds naar hetzelfde object; dat kan opnieuw worden ingevoegd. Zonder bovenliggend element doet de aanroep niets.

In tegenstelling tot parent.removeChild(element) heeft deze methode geen verwijzing naar het bovenliggende element nodig en retourneert zij undefined, niet het verwijderde knooppunt. Het voorbeeld gebruikt een losgekoppelde boom: het element hoeft geen deel uit te maken van het document.

Voorbeelden

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);

Resultaat

1
0
true
true
0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen