CKTIS / JavaScript
String.prototype.replace — Text ersetzen
replace() gibt einen Text zurück, in dem Treffer ersetzt wurden, ohne das Original zu ändern. Erfahre den Unterschied zwischen der Suche mit Zeichenfolgen und regulären Ausdrücken sowie zwischen Ersetzungsvorlagen und Ersetzungsfunktionen.
Version: 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 gibt bei einer einfachen Zeichenfolge oder einem standardmäßigen RegExp eine neue Zeichenfolge zurück; das Original bleibt unverändert. Gibt es keinen Treffer, wird der Inhalt unverändert zurückgegeben. Dies ist eine ECMAScript-Sprachfunktion und keine Browser-API.
Ein Zeichenfolgen-searchValue wird wörtlich behandelt und ersetzt nur das erste Vorkommen; eine leere Zeichenfolge trifft am Anfang. Ein standardmäßiger RegExp ohne g ersetzt höchstens einen Treffer; mit g werden alle gefundenen Treffer ersetzt. Ein Objekt mit einer [Symbol.replace]-Methode kann ein eigenes Verhalten einschließlich des Ergebnisses festlegen.
Ein Zeichenfolgen-replaceValue interpretiert $$ als $, $& als den gesamten Treffer und $1 als die erste vorhandene Erfassungsgruppe. Eine Ersetzungsfunktion erhält den Treffer, danach die erfassten Gruppen, den Index und die Eingabezeichenfolge; bei benannten Gruppen kommt ein abschließendes groups-Objekt hinzu. Der Index zählt UTF-16-Codeeinheiten. Das Funktionsergebnis wird in eine Zeichenfolge umgewandelt, aber $-Sequenzen werden nicht interpretiert.
Das Beispiel vergleicht die Ersetzung des ersten Treffers, die globale Ersetzung, einen Gruppenverweis und ein wörtliches Funktionsergebnis. Die Ausgabe von text zeigt außerdem, dass das Original unverändert bleibt.
Beispiele
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);Ergebnis
dog cat dog dog [cat] [cat] $& $& cat cat
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.