JavaScript String replace() Method

Definition at Paggamit

replace() Ang paraan ay naghahanap ng halaga o regular expression sa string.

replace() Ang paraan ay ibibigay ang bagong string na may pinagsukling halaga.

replace() Ang paraan ay hindi magbabago ng orihinal na string.

Paalala:Kung nagbabago ka ng halaga, gagawin lamang ang pagsukliin sa unang pagkakataon. Para sa pagsukliin ng lahat ng pagkakataon, gamitin ang may g Regular Expression ng Set ng Modifikador.

Mga ibang pagbabasa:

Tuturuan sa Regular Expression

Mga Referensya sa Regular Expression

Sample

Halimbawa 1

Pagsukliin ang Microsoft:

let text = "Bisita ang Microsoft!";
let result = text.replace("Microsoft", "W3School");

亲自试一试

Halimbawa 2

Pangkalahatang pagsukliin:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/g, "red");

亲自试一试

Halimbawa 3

Pangkalahatang, walang pagtatangi sa laki ng pagbigkas na pagsukliin:

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
支持 支持 支持 支持 支持 支持

相关页面

JavaScript 字符串

JavaScript 字符串方法

JavaScript 字符串搜索