CKTIS / JavaScript
Element.remove(): Ein Element ablösen
Die Methode element.remove() löst ein Element von seinem Elternelement. Sie nimmt keine Argumente entgegen, gibt undefined zurück und bewirkt nichts, wenn das Element kein Elternelement hat.
Version: 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 bezeichnet die Instanzmethode element.remove(), die über das ChildNode-Mixin bereitgestellt wird. Sie ist eine DOM-API und keine von ECMAScript definierte Funktion.
Die Methode löst das Element samt seinem Teilbaum von seinem Elternelement. Eine gespeicherte Referenz zeigt weiterhin auf dasselbe Objekt; es kann erneut eingefügt werden. Ohne Elternelement bewirkt der Aufruf nichts.
Anders als parent.removeChild(element) benötigt diese Methode keine Referenz auf das Elternelement und gibt undefined zurück, nicht den entfernten Knoten. Das Beispiel verwendet einen abgetrennten Baum: Das Element muss nicht zum Dokument gehören.
Beispiele
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);Ergebnis
1 0 true true 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.