KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Node.removeChild(): een kindknooppunt losmaken

De methode parent.removeChild(child) maakt een direct kind los van de bovenliggende node en geeft dezelfde node terug, die opnieuw kan worden ingevoegd.

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

parent.removeChild(child)

Node.removeChild is een instantiemethode van de interface Node, gedefinieerd door de DOM-standaard en niet door ECMAScript. Roep parent.removeChild(child) aan op de bovenliggende node; child kan ook een tekstnode zijn.

De methode geeft hetzelfde child-object terug. Na het losmaken is de waarde van parentNode null; de behouden node kan met appendChild opnieuw worden ingevoegd. Door het losmaken worden het object en de subboom ervan niet vernietigd.

Als child een Node is maar geen direct kind van parent, werpt de methode een DOMException met de naam NotFoundError op. Dat gebeurt bijvoorbeeld als je een dieper gelegen afstammeling meegeeft of een al losgemaakt kind opnieuw probeert te verwijderen. Als je null meegeeft, ontstaat er tijdens de argumentconversie volgens Web IDL een TypeError, nog voordat de bovenliggende node wordt gecontroleerd. Het voorbeeld vereist een browser-DOM; een Node.js-versie alleen toont niet aan dat deze API beschikbaar is.

Voorbeelden

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

Resultaat

true
true
0
Hello

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