CKTIS / JavaScript
Node.removeChild(): einen untergeordneten Knoten abtrennen
Die Methode parent.removeChild(child) trennt ein direktes Kind von seinem Elternknoten und gibt denselben Knoten zurück, der erneut eingefügt werden kann.
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
parent.removeChild(child)Node.removeChild ist eine Instanzmethode der Schnittstelle Node, die im DOM-Standard und nicht in ECMAScript definiert ist. Rufe parent.removeChild(child) am Elternknoten auf; child kann auch ein Textknoten sein.
Die Methode gibt dasselbe child-Objekt zurück. Nach dem Abtrennen ist sein parentNode gleich null; der beibehaltene Knoten kann mit appendChild erneut eingefügt werden. Durch das Abtrennen werden weder das Objekt noch sein Teilbaum zerstört.
Ist child ein Node, aber kein direktes Kind von parent, löst die Methode eine DOMException mit dem Namen NotFoundError aus. Das gilt etwa für einen weiter entfernten Nachfahren oder für den Versuch, ein bereits abgetrenntes Kind erneut zu entfernen. Bei Übergabe von null wird bereits bei der Argumentkonvertierung nach Web IDL ein TypeError ausgelöst, noch bevor der Elternknoten geprüft wird. Das Beispiel setzt ein Browser-DOM voraus; eine Node.js-Version allein belegt nicht, dass diese API verfügbar ist.
Beispiele
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);Ergebnis
true true 0 Hello
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.