KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Node.insertBefore — invoegen vóór een kindknooppunt

Node.insertBefore voegt een knooppunt in vóór een opgegeven kindknooppunt, of verplaatst het daarheen. Als je null doorgeeft, wordt het aan het einde 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.insertBefore(node, child)

Roep Node.insertBefore aan op de ouder: parent.insertBefore(node, child). child moet een direct kind van die ouder zijn of null (om het knooppunt achteraan toe te voegen). Geef beide argumenten op. De methode retourneert node.

Een bestaand knooppunt wordt verplaatst, niet gekopieerd. Bij een DocumentFragment worden de kindknooppunten ingevoegd; het geretourneerde fragment is leeg.

Een ongeldige hiërarchie, zoals een cyclus, veroorzaakt HierarchyRequestError. De methode controleert of het invoegen een cyclus zou veroorzaken voordat ze controleert of child bij de ouder hoort. Als er een cyclus zou ontstaan, geeft de methode HierarchyRequestError, ook als child niet bij de ouder hoort. Als de eerdere controles slagen en child niet null is en geen direct kind van de ouder is, geeft de methode NotFoundError. Dit is een DOM-API, geen ECMAScript; alleen de aanwezigheid van Node.js 24 bewijst niet dat het DOM beschikbaar is.

Voorbeelden

const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);

Resultaat

AB
true
BA

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