Symbol.replace 是用于自定义对象在 String.prototype.replace() 中行为的内置符号；需在对象上定义方法，接收 string 和 replaceValue 参数并返回字符串，仅当对象为 replace() 第一参数时生效。
Symbol.replace 是一个内置的符号（Symbol），用于自定义对象在调用 String.prototype.replace() 时的行为。当你把某个对象传给 replace() 的第二个参数（即替换器），或者作为第一个参数（正则表达式或具有该 Symbol 的对象）时，JavaScript 引擎会检查该对象是否实现了 Symbol.replace 方法，并优先调用它。
要定义 Symbol.replace，只需在对象上设置一个键为 Symbol.replace 的方法，该方法接收两个参数：string（被搜索的字符串）和 replaceValue（替换内容或函数），并返回替换后的字符串。
如何在普通对象上定义 Symbol.replace
const myReplacer = {
[Symbol.replace](string, replaceValue) {
// 自定义替换逻辑：比如把所有数字替换成 'X'
return string.replace(/d/g, 'X');
}
};
console.log('abc123'.replace(myReplacer, '')); // "abcXXX"注意：replaceValue 参数是 replace() 调用时传入的第二个参数（如字符串、函数等），但在这个自定义方法里你不一定需要使用它——你可以完全忽略它，按自己的规则处理 string。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
Symbol.replace 在类中怎么实现
class CustomRegex {
constructor(pattern) {
this.pattern = pattern;
}
[Symbol.replace](string, replacement) {
// 模拟 RegExp 的 replace 行为
const regex = new RegExp(this.pattern, 'g');
return string.replace(regex, replacement);
}
}
const custom = new CustomRegex('\w+');
console.log('hello world'.replace(custom, 'X')); // "X X"这样你就能让自定义类“表现得像正则”，被 replace() 正确识别和调用。
立即学习“Java免费学习笔记（深入）”；
常见误区和注意事项
-
Symbol.replace方法必须是函数，且必须是可枚举的（默认就是），不能是 getter 或箭头函数（因为需要this上下文）。 - 它只在
replace()的第一个参数是该对象时生效；如果对象是第二个参数（替换器），JS 不会查它的Symbol.replace。 - 原生正则表达式、字符串、函数等都已内置实现了
Symbol.replace，所以能直接用。 - 如果你返回的不是字符串，
replace()会自动转成字符串（例如返回null→"null"）。
实际用途举例
- 实现轻量级模板引擎（用自定义对象解析
${key}） - 封装日志脱敏逻辑（如自动隐藏手机号）
- 构建可复用的文本处理器（如统一转义 HTML 特殊字符）
const censor = {
[Symbol.replace](str) {
return str.replace(/1[3-9]d{9}/g, '****-****-****');
}
};
console.log('联系方式：13812345678'.replace(censor)); // "联系方式：****-****-****"不复杂但容易忽略细节。
