CKTIS / JavaScript
String.prototype.replace — tekst vervangen
replace() retourneert tekst waarin overeenkomsten zijn vervangen, zonder het origineel te wijzigen. Leer het verschil tussen zoeken met tekenreeksen en reguliere expressies, en tussen vervangingssjablonen en vervangingsfuncties.
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.replace(searchValue, replaceValue)String.prototype.replace retourneert met een gewone tekenreeks of standaard-RegExp een nieuwe tekenreeks; het origineel blijft ongewijzigd. Als er geen overeenkomst is, wordt de inhoud ongewijzigd teruggegeven. Dit is een ECMAScript-taalfunctie, geen browser-API.
Een tekenreeks als searchValue wordt letterlijk behandeld en vervangt alleen de eerste keer dat deze voorkomt; een lege tekenreeks komt overeen aan het begin. Een standaard-RegExp zonder g vervangt hoogstens één overeenkomst; met g vervangt deze alle gevonden overeenkomsten. Een object met een [Symbol.replace]-methode kan eigen gedrag definiëren, inclusief het resultaat.
Een tekenreeks als replaceValue interpreteert $$ als $, $& als de volledige overeenkomst en $1 als de eerste bestaande vastgelegde groep. Een vervangingsfunctie ontvangt de overeenkomst, daarna de vastgelegde groepen, de index en de invoertekenreeks; bij benoemde groepen wordt een object groups als laatste argument toegevoegd. De index telt UTF-16-code-eenheden. Het functieresultaat wordt omgezet naar een tekenreeks, maar $-reeksen worden niet geïnterpreteerd.
Het voorbeeld vergelijkt vervanging van alleen de eerste overeenkomst, globale vervanging, een verwijzing naar een vastgelegde groep en een letterlijk functieresultaat. Door ook text af te drukken, controleer je dat het origineel ongewijzigd blijft.
Voorbeelden
const text = "cat cat";
console.log(text.replace("cat", "dog"));
console.log(text.replace(/cat/g, "dog"));
console.log(text.replace(/(cat)/g, "[$1]"));
console.log(text.replace(/cat/g, () => "$&"));
console.log(text);Resultaat
dog cat dog dog [cat] [cat] $& $& cat cat
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.