CKTIS / JavaScript
Element.prepend — invoegen aan het begin van een element
Element.prepend voegt knooppunten en tekst in vóór het eerste kind van een element. Als a en b verschillende elementen zijn, voegt prepend(a, b, a) eerst b en daarna a in, zonder a te dupliceren.
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.prepend(...nodes)Element.prepend is een DOM-methode uit de ParentNode-mixin, geen ECMAScript-functie. De methode accepteert knooppunten en tekenreeksen en retourneert undefined.
De argumenten worden vóór het eerste kind ingevoegd, ook als dat een tekstknooppunt is. Tekenreeksen worden Text-knooppunten, geen HTML-opmaak. Bestaande knooppunten worden verplaatst, niet gekopieerd.
Als de hiërarchische beperkingen van de boom worden geschonden, wordt HierarchyRequestError gegooid. Het voorbeeld vereist een DOM-omgeving; alleen de Node.js-versie stelt niet vast of deze methode beschikbaar is.
Voorbeelden
const container = document.createElement('div');
const label = document.createElement('span');
label.textContent = 'Start';
container.textContent = 'End';
const result = container.prepend(label, ' | ');
console.log(container.textContent);
console.log(container.firstChild === label);
console.log(result === undefined);Resultaat
Start | End 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.