如何检测Node.js代码在特定版本的兼容性？解决replaceAll检测失效问题

可以检测Node.js代码在特定版本下的API兼容性，针对你遇到的replaceAll这类低版本不支持的函数调用问题，推荐以下几种方案：

1. 使用ESLint + eslint-plugin-node插件 #

这是编码阶段就能生效的静态检查方案，可直接识别目标Node.js版本不支持的API。

配置步骤： #

• 安装依赖：

  npm install eslint eslint-plugin-node --save-dev
  

• 在项目根目录创建.eslintrc.js，指定目标Node.js版本：

  module.exports = {
    env: {
      node: true,
      es2021: true
    },
    plugins: ['node'],
    rules: {
      // 方式1：直接指定Node版本
      "node/no-unsupported-features/es-syntax": ["error", { version: "14.x" }],
      // 方式2：自动读取package.json的engines字段
      // "node/no-unsupported-features/es-syntax": ["error", { checkEngines: true }]
    }
  };
  

配置完成后，ESLint会自动标记Node.js 14不支持的语法/API（比如String.prototype.replaceAll），并抛出错误提示。

2. 使用es-check工具 #

es-check可批量检测代码是否符合指定ECMAScript或Node.js版本要求，适合快速校验全项目文件。

使用步骤： #

• 安装依赖：

  npm install es-check --save-dev
  

• 执行检测命令（Node.js 14不支持ES2021的replaceAll，因此指定ES2020版本）：

  es-check es2020 ./src/**/*.js --node 14
  

若代码包含目标版本不支持的特性，工具会直接抛出兼容性错误。

3. 在CI流程中添加多版本Node测试 #

借助你已使用的GitHub Actions，可在工作流中添加多版本Node环境的运行步骤，直接在目标版本下执行代码或测试，提前发现运行时故障。

示例GitHub Actions配置片段：

jobs:
  compatibility-test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [14.x, 16.x]
    steps:
      - uses: actions/checkout@v4
      - name: Set up Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
      - run: npm install
      - run: npm run build && npm test

在Node.js 14环境下运行时，replaceAll调用会直接抛出TypeError: str.replaceAll is not a function错误，在CI阶段就能拦截问题。

补充说明 #

你配置的package.json中的engines字段仅用于告知包管理器Node版本要求，本身不会自动检测代码兼容性，需要配合上述静态检查工具或CI多版本测试，才能实现完整的兼容性校验。

内容的提问来源于stack exchange，提问作者Kiran Parajuli