KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.replaceAll — alle overeenkomsten vervangen

replaceAll vervangt elke niet-overlappende overeenkomst van een tekenreeks of globale reguliere expressie, zonder de oorspronkelijke tekenreeks te wijzigen. De vervanging kan tekst of een functie zijn.

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

text.replaceAll(searchValue, replaceValue)

Bij een tekenreeks als patroon geeft String.prototype.replaceAll een tekenreeks terug waarin elke niet-overlappende overeenkomst van links naar rechts is vervangen. De oorspronkelijke tekenreeks blijft ongewijzigd en ingevoegde tekst wordt niet opnieuw doorzocht. Als er geen overeenkomsten zijn, blijft de inhoud van het resultaat hetzelfde. In tegenstelling tot replace met een tekenreeks als patroon stopt de methode niet na de eerste overeenkomst.

Een tekenreeks als searchValue wordt letterlijk geïnterpreteerd: "." betekent een punt, niet een willekeurig teken. Een reguliere expressie moet de vlag g hebben; ontbreekt die, dan ontstaat een TypeError. Een leeg tekenreekspatroon komt overeen met elke grens tussen UTF-16-code-eenheden, ook aan het begin en einde: "ab".replaceAll("", "-") levert "-a-b-" op. Een object met een [Symbol.replace]-methode kan de bewerking overnemen en het resultaat bepalen.

replaceValue kan tekst of een functie zijn. In vervangingstekst betekent $$ een dollarteken en $& de overeenkomst; reguliere expressies ondersteunen ook verwijzingen naar capturegroepen. Gebruik () => replacement om dynamische tekst met zulke reeksen letterlijk in te voegen. Bij een tekenreekspatroon ontvangt de functie (match, offset, string); bij een reguliere expressie ontvangt ze daarnaast de capturegroepen vóór de offset en, als er benoemde groepen zijn, aan het einde een object met benoemde groepen.

De methode maakt deel uit van ECMAScript 2021, niet van de Web APIs. De specificatie is geen compatibiliteitstabel voor browsers; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning. Controleer de doelomgeving, bijvoorbeeld met typeof String.prototype.replaceAll === "function".

Voorbeelden

const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);

Resultaat

a-b-a
A.b.A
$&.b.$&
a.b.a

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