CKTIS / JavaScript
String.prototype.replaceAll — alle Treffer ersetzen
replaceAll ersetzt jeden nicht überlappenden Treffer eines Strings oder eines globalen regulären Ausdrucks, ohne den ursprünglichen String zu verändern. Als Ersatz sind Text oder eine Funktion möglich.
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.replaceAll(searchValue, replaceValue)Bei einem String-Muster gibt String.prototype.replaceAll einen String zurück, in dem jeder nicht überlappende Treffer von links nach rechts ersetzt wurde. Der ursprüngliche String bleibt unverändert, und eingefügter Text wird nicht erneut durchsucht. Gibt es keine Treffer, bleibt der Inhalt des Ergebnisses unverändert. Anders als replace mit einem String-Muster hört die Methode nicht nach dem ersten Treffer auf.
Ein String als searchValue wird wörtlich behandelt: "." bedeutet einen Punkt und nicht ein beliebiges Zeichen. Ein regulärer Ausdruck muss das Flag g haben; fehlt es, wird ein TypeError ausgelöst. Ein leeres String-Muster trifft jede Grenze zwischen UTF-16-Codeeinheiten, einschließlich Anfang und Ende: "ab".replaceAll("", "-") ergibt "-a-b-". Ein Objekt mit einer [Symbol.replace]-Methode kann den Vorgang übernehmen und sein Ergebnis bestimmen.
replaceValue kann Text oder eine Funktion sein. Im Ersatztext steht $$ für ein Dollarzeichen und $& für den Treffer; bei regulären Ausdrücken werden außerdem Verweise auf Erfassungsgruppen unterstützt. Um dynamischen Text mit solchen Sequenzen wörtlich einzufügen, verwende () => replacement. Bei einem String-Muster erhält die Funktion (match, offset, string); bei einem regulären Ausdruck kommen die Erfassungsgruppen vor dem Offset und, sofern benannte Gruppen vorhanden sind, am Ende ein Objekt mit benannten Gruppen hinzu.
Die Methode gehört zu ECMAScript 2021, nicht zu den Web APIs. Die Spezifikation ist keine Browser-Kompatibilitätstabelle; dass Node 24 in einem Repository vorhanden ist, belegt keine Browser-Unterstützung. Prüfe die Zielumgebung, zum Beispiel mit typeof String.prototype.replaceAll === "function".
Beispiele
const text = "a.b.a";
console.log(text.replaceAll(".", "-"));
console.log(text.replaceAll(/a/g, "A"));
console.log(text.replaceAll("a", () => "$&"));
console.log(text);Ergebnis
a-b-a A.b.A $&.b.$& a.b.a
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.