String.prototype.replaceAll()

pattern

Kann ein String oder ein Objekt mit einer Symbol.replace-Methode sein — das typische Beispiel ist ein regulärer Ausdruck. Jeder Wert, der nicht über die Symbol.replace-Methode verfügt, wird in einen String umgewandelt.

Wenn pattern ein Regex ist, dann muss es das globale (g) Flag gesetzt haben, ansonsten wird ein TypeError ausgelöst.

replacement

Kann ein String oder eine Funktion sein. Der Ersatz hat dieselbe Semantik wie der von String.prototype.replace().

Ein neuer String, bei dem alle Übereinstimmungen eines Musters durch einen Ersatz ersetzt wurden.

TypeError

Wird ausgelöst, wenn das pattern ein Regex ist, das nicht das globale (g) Flag gesetzt hat (die flags-Eigenschaft enthält kein "g").

Diese Methode verändert den String-Wert, auf den sie angewendet wird, nicht. Sie gibt einen neuen String zurück.

Im Gegensatz zu replace() ersetzt diese Methode alle Vorkommen eines Strings, nicht nur das erste. Während es auch möglich ist, replace() mit einem dynamisch konstruierten globalen Regex über RegExp() zu verwenden, um alle Instanzen eines Strings zu ersetzen, kann dies unbeabsichtigte Folgen haben, wenn der String Sonderzeichen enthält, die in regulären Ausdrücken eine Bedeutung haben (was passieren könnte, wenn der Ersatzstring aus Benutzereingaben kommt). Während Sie diesen Fall mit RegExp.escape() mildern können, um den regulären Ausdruck zu einem literalen Muster zu machen, ist es besser, einfach replaceAll() zu verwenden und den String zu übergeben, ohne ihn in ein Regex umzuwandeln.

function unsafeRedactName(text, name) {
  return text.replace(new RegExp(name, "g"), "[REDACTED]");
}
function safeRedactName(text, name) {
  return text.replaceAll(name, "[REDACTED]");
}

const report =
  "A hacker called ha.*er used special characters in their name to breach the system.";

console.log(unsafeRedactName(report, "ha.*er")); // "A [REDACTED]s in their name to breach the system."
console.log(safeRedactName(report, "ha.*er")); // "A hacker called [REDACTED] used special characters in their name to breach the system."

Wenn pattern ein Objekt mit einer Symbol.replace-Methode ist (einschließlich RegExp-Objekten), wird diese Methode mit dem Zielstring und dem replacement als Argumenten aufgerufen. Ihr Rückgabewert wird zum Rückgabewert von replaceAll(). In diesem Fall wird das Verhalten von replaceAll() vollständig durch die [Symbol.replace]()-Methode bestimmt und wird daher dasselbe Ergebnis wie replace() haben (abgesehen von der zusätzlichen Eingabevalidierung, dass das Regex global ist).

Wenn das pattern ein leerer String ist, wird der Ersatz zwischen jede UTF-16-Code-Einheit eingefügt, ähnlich dem Verhalten von split().

"xxx".replaceAll("", "_"); // "_x_x_x_"

Für weitere Informationen darüber, wie Regex-Eigenschaften (insbesondere das sticky-Flag) mit replaceAll() interagieren, siehe RegExp.prototype[Symbol.replace]().

Bei Verwendung eines regulären Ausdrucks als Suchwert muss dieser global sein. Das hier wird nicht funktionieren:

"aabbcc".replaceAll(/b/, ".");
// TypeError: replaceAll must be called with a global RegExp

Das hier wird funktionieren:

"aabbcc".replaceAll(/b/g, ".");
("aa..cc");

• Polyfill von String.prototype.replaceAll in core-js
• Leitfaden zu regulären Ausdrücken
• String.prototype.replace()
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype.test()