#output.polyfill

• 类型： 'entry' | 'usage' | 'off'
• 默认值： 'off'

控制 polyfills 的注入方式。

请查看 Polyfill 方案 了解详细内容。

#安装 core-js

当你启用 polyfill 注入时，请确保项目中已安装 core-js v3，它是一个流行的 JavaScript polyfill 库。

npm add core-js

yarn add core-js

pnpm add core-js

bun add core-js

deno add npm:core-js

#可选值

#usage

当 output.polyfill 配置为 'usage' 时，Rsbuild 会检查每个经过 SWC 编译的文件中使用的 API，并注入目标浏览器所需的 polyfill。未经过 SWC 编译的文件不会被检查，可通过 source.include 添加需要编译的文件。

export default {
  output: {
    polyfill: 'usage',
  },
};

#entry

当 output.polyfill 配置为 'entry' 时，Rsbuild 会在每个入口文件中注入 polyfills。注入的 core-js polyfill 根据目标浏览器选择，不取决于代码中使用了哪些 API，因此可能会增加产物体积。

export default {
  output: {
    polyfill: 'entry',
  },
};

#off

当 output.polyfill 配置为 'off' 时，Rsbuild 不会注入 polyfills，你需要自行处理代码的兼容性。

export default {
  output: {
    polyfill: 'off',
  },
};

#版本历史