KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Node.replaceChild — een kind vervangen

Node.replaceChild vervangt een direct kind van een bovenliggend knooppunt en geeft het verwijderde knooppunt terug. Het vervangende knooppunt is het eerste argument.

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

const removedNode = parent.replaceChild(newChild, oldChild);

parent.replaceChild(newChild, oldChild) vervangt oldChild door newChild en geeft oldChild terug. De argumenten moeten knooppunten zijn, geen tekenreeksen. Dit is een DOM-API, geen functie van ECMAScript.

Een bestaande newChild wordt verplaatst, niet gekopieerd. Een DocumentFragment voegt de kinderen ervan in, niet het fragment zelf.

Een ongeldige structuur, zoals een cyclus, kan leiden tot HierarchyRequestError. De methode controleert of de vervanging een cyclus zou veroorzaken voordat ze controleert of oldChild een direct kind van parent is. Als de eerdere controles geen fout opleveren en oldChild geen direct kind van parent is, werpt de methode NotFoundError op.

Voorbeelden

const parent = document.createElement('div');
const oldChild = document.createTextNode('old');
const newChild = document.createTextNode('new');
parent.appendChild(oldChild);

const removedNode = parent.replaceChild(newChild, oldChild);

console.log(parent.textContent);
console.log(removedNode === oldChild);
console.log(oldChild.parentNode === null);

Resultaat

new
true
true

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