WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen