Skip to main content

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 高阶技能