JavaScript String replace() 方法
定义和用法
replace()
方法在字符串中搜索值或正则表达式。
replace()
方法返回已替换值的新字符串。
replace()
方法不会更改原始字符串。
提示:如果您替换值,则只会替换第一个实例。如需替换所有实例,请使用带有 g
修饰符集的正则表达式。
另请参阅:
实例
例子 1
替换 Microsoft:
let text = "Visit Microsoft!"; let result = text.replace("Microsoft", "W3School");
例子 2
全局替换:
let text = "Mr Blue has a blue house and a blue car"; let result = text.replace(/blue/g, "red");
例子 3
全局的、不区分大小写的替换:
let text = "Mr Blue has a blue house and a blue car"; let result = text.replace(/blue/gi, "red");
例子 4
返回替换文本的函数:
let text = "Mr Blue has a blue house and a blue car"; let result = text.replace(/blue|house|car/gi, function (x) { return x.toUpperCase(); });
语法
string.replace(regexp, replacement)
参数
参数 | 描述 |
---|---|
regexp |
必需。要搜索的值或正则表达式。 该参数指定要替换的模式的 RegExp 对象。 如果该参数是字符串,则将它作为要检索的直接量文本模式。 |
replacement |
必需。字符串。 指定替换文本或生成替换文本的函数。 |
返回值
类型 | 描述 |
---|---|
字符串 | 已替换指定值的新字符串。 |
技术细节
返回值
返回新的字符串,是用 replacement 替换了 regexp 的第一次匹配或所有匹配之后得到的。
说明
字符串 string 的 replace()
方法执行的是查找并替换的操作。它将在 string 中查找与 regexp 相匹配的子字符串,然后用 replacement 来替换这些子串。如果 regexp 具有全局标志 g,那么 replace()
方法将替换所有匹配的子串。否则,它只替换第一个匹配子串。
replacement 可以是字符串,也可以是函数。如果它是字符串,那么每个匹配都将由字符串替换。但是 replacement 中的 $
字符具有特定的含义。如下表所示,它说明从模式匹配得到的字符串将用于替换。
字符 | 替换文本 |
---|---|
$1、$2、...、$99 | 与 regexp 中的第 1 到第 99 个子表达式相匹配的文本。 |
$& | 与 regexp 相匹配的子串。 |
$` | 位于匹配子串左侧的文本。 |
$' | 位于匹配子串右侧的文本。 |
$$ | 直接量符号。 |
注意:ECMAScript v3 规定,replace()
方法的参数 replacement 可以是函数而不是字符串。在这种情况下,每个匹配都调用该函数,它返回的字符串将作为替换文本使用。该函数的第一个参数是匹配模式的字符串。接下来的参数是与模式中的子表达式匹配的字符串,可以有 0 个或多个这样的参数。接下来的参数是一个整数,声明了匹配在 string 中出现的位置。最后一个参数是 string 本身。
浏览器支持
replace()
是 ECMAScript1 (ES1) 特性。
所有浏览器都完全支持 ES1 (JavaScript 1997):
Chrome | IE | Edge | Firefox | Safari | Opera |
---|---|---|---|---|---|
Chrome | IE | Edge | Firefox | Safari | Opera |
支持 | 支持 | 支持 | 支持 | 支持 | 支持 |