close
Rslib
  • 简体中文

      • lib.syntax

      • 类型：
      type EcmaScriptVersion =
  | 'es5'
  | 'es6'
  | 'es2015'
  | 'es2016'
  | 'es2017'
  | 'es2018'
  | 'es2019'
  | 'es2020'
  | 'es2021'
  | 'es2022'
  | 'es2023'
  | 'es2024'
  | 'es2025'
  | 'esnext';

type Syntax = EcmaScriptVersion | string[];
      • 默认值：
        • 当 output.target 为 'node'，且 package.json#engines.node 可推断出最低 Node.js 版本时，使用 ['node >= <minimum-version>']
        • 其他情况下，使用 'esnext'
      • 命令行： --syntax <value>（可重复，例如 --syntax es2018 或 --syntax="node 14" --syntax="Chrome 103"）
      • 顶层配置： 支持

      配置 JavaScript 和 CSS 将被降级的语法版本。

      参考 产物兼容性 - 语法降级 了解更多详情。

      默认行为

      当 output.target 设置为 'node' 且未配置 syntax 时，Rslib 会尝试根据 package.json#engines.node 推断语法目标。如果 package.json 声明了可推断出最低版本的 engines.node 范围，Rslib 会使用该范围中的最低 Node.js 版本作为语法目标。

      package.json
      {
  "engines": {
    "node": "^20.19.0 || >=22.12.0"
  }
}

      上述配置等效于：

      rslib.config.ts
      export default {
  lib: [
    {
      syntax: ['node >= 20.19.0'],
    },
  ],
};

      其他情况下，Rslib 默认使用 'esnext'。这意味着产物会以主流浏览器（Chrome / Firefox / Edge / macOS Safari / iOS Safari）或 Node.js 的最新版本为语法目标，具体取决于 output.target。

      如需覆盖该默认行为，显式设置 syntax 即可。

      设置 ECMAScript 版本

      你可以直接设置 ECMAScript 版本，例如 es2015、es2022 等。

      rslib.config.ts
      export default {
  lib: [
    {
      syntax: 'es2015',
    },
  ],
};

      设置 Browserslist 查询

      你也可以设置 Browserslist 查询语句，例如 last 2 versions、> 1%、node >= 16、chrome >= 80 等。

      rslib.config.ts
      export default {
  lib: [
    {
      syntax: ['last 2 versions', '> 1%'],
    },
  ],
};

      混合使用 ECMAScript 版本和 browserslist 查询

      你也可以混合使用 ECMAScript 版本和 Browserslist 查询语句，例如 es2015 和 node 20。Rslib 会将 ECMAScript 版本转换为 Browserslist 查询语句，然后将它们合并在一起。

      rslib.config.ts
      export default {
  lib: [
    {
      syntax: ['es2015', 'node 20'],
    },
  ],
};