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 的第一次匹配或所有匹配之后得到的。

说明

字符串 stringreplace() 方法执行的是查找并替换的操作。它将在 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
支持 支持 支持 支持 支持 支持

相关页面

JavaScript 字符串

JavaScript 字符串方法

JavaScript 字符串搜索