String.prototype.replaceAll()

pattern

Kann ein String oder ein Objekt mit einer Symbol.replace Methode sein — das typische Beispiel hierfür ist ein regulärer Ausdruck. Jeder Wert, der nicht die Symbol.replace Methode hat, wird in einen String konvertiert.

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

replacement

Kann ein String oder eine Funktion sein. Das Ersatzmuster hat die gleichen Semantiken wie bei String.prototype.replace().

Ein neuer String, bei dem alle Vorkommen eines Musters durch ein Ersatzmuster ersetzt werden.

TypeError

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

Diese Methode verändert nicht den String-Wert, auf den sie angewendet wird. 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 globalen Regex dynamisch konstruiert mit 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 kann, wenn der Ersatzstring aus Benutzereingaben stammt). Obwohl Sie diesen Fall mit RegExp.escape() entschärfen können, indem Sie den regulären Ausdrucksstring in ein wörtliches Muster umwandeln, ist es besser, einfach replaceAll() zu verwenden und den String ohne Umwandlung in ein Regex zu übergeben.

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 Objekte), wird diese Methode mit dem Zielstring und replacement als Argumente aufgerufen. Ihr Rückgabewert wird der Rückgabewert von replaceAll(). In diesem Fall ist das Verhalten von replaceAll() vollständig durch die [Symbol.replace]() Methode codiert und hat daher dasselbe Ergebnis wie replace() (abgesehen von der zusätzlichen Eingabevalidierung, dass das Regex global ist).

Wenn das pattern ein leerer String ist, wird das Ersatzmuster zwischen jedem UTF-16-Codeeinheit 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]().

Wenn ein regulärer Ausdruck als Suchwert verwendet wird, muss er global sein. Dies funktioniert nicht:

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

Das wird funktionieren:

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

• Polyfill von String.prototype.replaceAll in core-js
• es-shims Polyfill von String.prototype.replaceAll
• Reguläre Ausdrücke Leitfaden
• String.prototype.replace()
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype.test()