KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen