TypeScript编译目标为ES2020时未转换String.prototype.replaceAll问题

TypeScript编译器不应该也不会自动将text.replaceAll(' ', '-')转换为适配ES2020的兼容表达式，原因如下：

• TypeScript的能力边界仅包含静态类型检查、ECMAScript新语法的降级转译两类，不包含内置对象新增API的兼容补全（即polyfill逻辑）。String.prototype.replaceAll属于ES2021新增的API能力，不属于新语法范畴，因此不在TypeScript的默认转换范围内。
• 你当前配置中的"lib": ["ESNext.String"]仅作用于类型检查阶段：它会告诉TypeScript“假设运行环境存在ESNext阶段的String相关扩展API”，因此编译时不会抛出replaceAll不存在的类型错误，但不会为运行环境补充该API的实现。
• ES2020标准本身未包含replaceAll定义，且Node.js 14.17.3的运行时也没有实现该API，因此运行时会直接报错。

可行解决方法 #

• 替换为兼容实现：将replaceAll调用替换为原生支持的全局正则replace写法，二者功能完全等价：

const newText = text.replace(/ /g, '-')

• 引入polyfill：使用core-js等polyfill库，按需补充String.prototype.replaceAll的运行时实现。
• 升级运行环境：将Node.js版本升级到16.0及以上（该版本开始原生支持replaceAll），同时将tsconfig的target调整为ES2021或更高版本。

内容的提问来源于stack exchange，提问作者Jeff Pal