CKTIS / JavaScript
Element.replaceWith — een element vervangen
Element.replaceWith vervangt een element binnen zijn bovenliggende element door knooppunten en tekst. Tekenreeksen worden tekst, geen HTML-opmaak.
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.replaceWith(...nodes)Element.replaceWith komt uit de ChildNode-mixin van de DOM-standaard, niet uit een editie van ECMAScript. De aanroep element.replaceWith(...nodes) vervangt het element zelf, niet zijn kindknooppunten; replaceChildren(...nodes) wijzigt juist de kindknooppunten, waaronder eventuele tekstknooppunten.
De argumenten zijn knooppunten en tekenreeksen, in de opgegeven volgorde. Knooppunten worden verplaatst, niet gekopieerd; tekenreeksen maken Text-knooppunten zonder HTML te verwerken. De methode retourneert undefined. Een aanroep zonder argumenten verwijdert het element; als het geen bovenliggend element heeft, verandert er niets.
Een ongeldige boomstructuur kan HierarchyRequestError veroorzaken. Controleer de beschikbaarheid met typeof Element.prototype.replaceWith === 'function' in een DOM-omgeving; de Node.js-versie alleen toont niet aan dat de functie wordt ondersteund.
Voorbeelden
const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);
const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');
console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);Resultaat
new <text> true 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.