CKTIS / JavaScript
Element.replaceChildren() — alle kindknooppunten vervangen
Element.replaceChildren() vervangt de kindknooppunten van een element door de knooppunten en tekenreeksen die als argumenten zijn opgegeven. Zonder argumenten verwijdert de methode alle kindknooppunten.
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.replaceChildren(...nodes)Element.replaceChildren komt uit de ParentNode-mixin van de DOM-standaard, niet uit ECMAScript. De methode vervangt alle kindknooppunten van een element, ook tekstknooppunten, en laat het element zelf intact. De methode retourneert undefined.
De argumenten zijn knooppunten of tekenreeksen en worden in de opgegeven volgorde verwerkt. Tekenreeksen worden Text-knooppunten en worden niet als HTML geparseerd. Bestaande knooppunten worden verplaatst, niet gekloond. Geef je hetzelfde knooppunt opnieuw op, dan wordt het verplaatst in plaats van dat er een extra kindknooppunt bijkomt. Als a en b verschillende elementen zijn, blijven na element.replaceChildren(a, b, a) eerst b en dan a over. element.replaceChildren() verwijdert alle kindknooppunten.
Een ongeldige hiërarchie, bijvoorbeeld een element in zichzelf invoegen, veroorzaakt een DOMException met de naam HierarchyRequestError.
Dit is een browser-DOM-API; de aanwezigheid van Node 24 bewijst niet dat deze beschikbaar is. Controleer in de doelomgeving typeof Element !== 'undefined' && typeof Element.prototype.replaceChildren === 'function'.
Voorbeelden
const box = document.createElement('div');
box.textContent = 'Old';
const label = document.createElement('strong');
label.textContent = 'New';
box.replaceChildren('Status: ', label);
console.log(box.textContent);
console.log(box.childNodes.length);
console.log(box.lastChild === label);
box.replaceChildren();
console.log(box.childNodes.length);Resultaat
Status: New 2 true 0
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.