replaceAll() 方法返回一个新字符串,其中所有匹配 pattern 的部分都被替换为 replacement。pattern 可以是一个字符串或一个 RegExp,replacement 可以是一个字符串或一个在每次匹配时调用的函数。原始字符串保持不变。
JavaScript Demo: String.replaceAll()
const paragraph = "I think Ruth's dog is cuter than your dog!";
console.log(paragraph.replaceAll("dog", "monkey"));
// Expected output: "I think Ruth's monkey is cuter than your monkey!"
// Global flag required when calling replaceAll with regex
const regex = /Dog/gi;
console.log(paragraph.replaceAll(regex, "ferret"));
// Expected output: "I think Ruth's ferret is cuter than your ferret!"
语法
replaceAll(pattern, replacement)
参数
-
pattern-
: 可以是一个字符串或一个具有
Symbol.replace方法的对象,典型的例子是正则表达式。任何没有Symbol.replace方法的值都将被强制转换为字符串。如果
pattern是一个正则表达式,则必须设置全局(g)标志,否则会抛出 TypeError。
-
-
replacement- : 可以是一个字符串或一个函数。替换字符串的语义与
String.prototype.replace()相同。
- : 可以是一个字符串或一个函数。替换字符串的语义与
返回值
返回一个新字符串,其中所有匹配 pattern 的部分都被替换为 replacement。
异常
描述
该方法不会修改调用它的字符串。它返回一个新字符串。
与 replace() 不同,该方法将替换所有匹配的字符串,而不仅仅是第一个。如果字符串不是静态已知的,那么这特别有用,因为调用 RegExp() 构造函数而不转义特殊字符可能会意外地改变它的语义。
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."
如果 pattern 是一个具有 Symbol.replace 方法的对象(包括 RegExp 对象),则该方法将被调用,并以目标字符串和 replacement 作为参数。它的返回值成为 replaceAll() 的返回值。在这种情况下,replaceAll() 的行为完全取决于 [Symbol.replace]() 方法,因此除了额外的输入验证(即正则表达式必须是全局的)之外,它将具有与 replace() 相同的结果。
如果 pattern 是一个空字符串,则替换内容将插入到每个 UTF-16 码元之间,类似于 split() 的行为。
"xxx".replaceAll("", "_"); // "_x_x_x_"
有关正则表达式属性(尤其是 sticky 标志)如何与 replaceAll() 交互的更多信息,请参阅 RegExp.prototype[Symbol.replace]()。
示例
使用 replaceAll()
"aabbcc".replaceAll("b", ".");
// 'aa..cc'
非全局正则表达式抛出错误
使用正则表达式搜索值时,它必须是全局的。下面的代码是不可行的:
"aabbcc".replaceAll(/b/, ".");
// TypeError: replaceAll must be called with a global RegExp
下面的代码可以正常运行:
"aabbcc".replaceAll(/b/g, ".");
("aa..cc");
规范
浏览器兼容性
参见
core-js中String.prototype.replaceAll的 polyfill- String.prototype.replace
- String.prototype.match
- RegExp.prototype.exec
- RegExp.prototype.test
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
