replace()

语法

replace(searchValue: { [Symbol.replace](string: string, replacer: (substring: string, ...args: any[]) => string): string; }, replacer: (substring: string, ...args: any[]) => string): string;

描述

返回一个由替换值替换一些或所有匹配的模式后的新字符串。

  • 第一个参数(匹配值)可以是字符串或者正则表达式

  • 第二个参数(替换值)可以是字符串或者函数,其中第二个参数是字符串时可以插入一些特殊的值

TIP

replace()方法有四种组合,分别是:

  • replace(substr, newSubStr)

  • replace(regexp, newSubStr)

  • replace(substr, replacer)

  • replace(regexp, replacer)

示例

TIP

以下示例均使用 const str = 'can you Celebrate'

特殊示例

// 不传入参数时返回原字符串
str.replace(); // 'can you Celebrate'
// 不传入第二个参数,第二个参数被视为 undefined
str.replace("y"); // 'can undefinedou Celebrate'

当第二个参数是字符串时,可以使用如下表格中的特殊变量

变量名代表的值
$$插入一个 "$"
$&插入匹配的子串
$`插入当前匹配的子串左边的内容
$'插入当前匹配的子串右边的内容
$n假如第一个参数是 RegExp 对象,并且 n 是个小于 100 的非负整数,那么插入第 n 个括号匹配的字符串。注意索引是从1开始
str.replace(/[b-c]/gi, "$$"); // '$an you $ele$rate'
str.replace(/[b-c]/gi, "$&★"); // 'c★an you C★eleb★rate'
str.replace(/[b-c]/gi, "$`★"); // '★an you can you ★elecan you Cele★rate'
str.replace(/[b-c]/gi, "$'★"); // 'an you Celebrate★an you elebrate★elerate★rate'
str.replace(/(^\w+).*?(\w+)$/, "$1"); // 'can'

replace(substr, newSubStr)

  • 仅用 newSubStr 替换 substr首次匹配到的内容,并区分大小写

  • 当 substr 是一个空字符串时,将在原字符串的首部加一个newSubStr

  • 匹配不到时返回原字符串

// 当第一个参数是字符串时,只替换“首次”匹配到的内容,并区分大小写
str.replace("y", "★"); // '★an you Celebrate'
// 当第一个参数是一个“空字符串”时,会在原字符串首部加上第二个参数
str.replace("", "★"); // '★can you Celebrate'
// 匹配不到时返回原字符串
str.replace("z", "★"); // 'can you Celebrate'

replace(regexp, newSubStr)

  • 根据正则匹配将匹配到的值用newSubStr替换

  • 当正则包含捕获组时,可用 $1 $2 $3...提取

str.replace(/[a-c]/, "★"); // '★an you Celebrate'
str.replace(/[a-c]/gi, "★"); // '★★n you ★ele★r★te'
str.replace(/(^\w+).*?(\w+)$/, "$1 $2"); // 'can Celebrate'

replace(substr, replacer)

参考

String.prototype.replace 高阶技能

Last updated on by YanceyOfficial