CKTIS / JavaScript
Element.before() — invoegen vóór een element
Element.before() voegt knooppunten en tekst in bij het bovenliggende knooppunt, niet in het element zelf. Normaal komen ze vóór het referentie-element te staan.
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
element.before(...nodes)Element.before is een DOM-methode uit de ChildNode-mixin, geen ECMAScript-functie. element.before(...nodes) accepteert knooppunten en tekenreeksen; tekenreeksen worden Text-knooppunten, geen HTML.
Bestaande knooppunten worden verplaatst en niet gekopieerd. Als je het referentie-element zelf als argument meegeeft, kan dat ook worden verplaatst. Als het bovenliggende knooppunt van target een Element of een DocumentFragment is, plaatst target.before(target, 'x') de tekst na target, niet ervoor. Als target het hoofdelement van het document is, veroorzaakt dezelfde aanroep een HierarchyRequestError: een fragment met een Text-knooppunt als direct kind kan niet in een Document worden ingevoegd. Bij een geslaagde aanroep retourneert de methode undefined.
Een element zonder bovenliggend knooppunt blijft ongewijzigd; het bovenliggende knooppunt hoeft niet bij het document te horen. Een ongeldige hiërarchie veroorzaakt HierarchyRequestError. In tegenstelling tot parent.insertBefore(node, element) roep je deze methode aan op het referentie-element.
Voorbeelden
const parent = document.createElement('div');
const target = document.createElement('span');
target.textContent = 'B';
parent.appendChild(target);
const first = document.createElement('strong');
first.textContent = 'A';
const result = target.before(first, ' + ');
console.log(parent.textContent);
console.log(parent.firstChild === first);
console.log(result === undefined);Resultaat
A + B 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.