String.prototype.replace()存在bug？传入$'作为替换值时输出不符合预期

这一现象并非方法实现存在bug，是完全符合ECMAScript规范定义的标准化行为，核心原因是开发者忽略了替换字符串的特殊解析规则，具体逻辑如下：

替换字符串的内置占位符规则 #

当调用String.prototype.replace()时，如果第二个替换值参数传入的是字符串，引擎不会直接将其作为纯字面量文本替换匹配内容，而是会优先解析其中以$开头的特殊占位符，这类占位符的固定语义包括：

• $$：插入字面量$字符
• $&：插入本次匹配到的完整子串
• $`：插入匹配位置之前的原字符串内容
• $'：插入匹配位置结束点之后的全部原字符串内容

示例代码的执行过程拆解 #

针对复现代码'A B'.replace('A', "$'")：

1. 原字符串为'A B'，匹配规则为查找首次出现的字符'A'，该匹配的覆盖区间是字符串索引0的位置，匹配结束点在索引1处
2. 开发者传入的替换值"$'"不会被识别为普通的$+单引号字符，而是会被引擎解析为上述规则中的内置占位符
3. 按照$'的语义，其对应的内容是匹配结束点（索引1）之后的全部原字符串，也就是' B'
4. 引擎将原字符串中匹配到的'A'替换为占位符对应的内容' B'，再拼接上原本保留的匹配区间之后的剩余原串' B'，最终得到输出结果' B B'，和实际运行表现完全一致。

达成预期效果的正确实现方式 #

如果要实现直觉中的效果——将匹配到的'A'替换为字面量的$'，最终输出$' B，可以采用两种无解析歧义的写法：

• 转义特殊占位符：将替换字符串写为"$$'"，其中$$会被解析为字面量$，后续的单引号为普通文本，最终替换内容就是$'
• 传递回调函数作为替换值：回调函数的返回值不会触发特殊占位符解析，可以直接返回需要的字面量字符串，示例代码为：

  console.log('A B'.replace('A', () => "$'")) // 输出 "$' B"
  

内容的提问来源于stack exchange，提问作者snehanshu.js