简体中文

output.polyfill

控制 polyfills 的注入方式。

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

可选值

当 output.polyfill 配置为 'usage' 时，Rsbuild 会在每个文件中根据代码中使用的 API 注入 polyfills。这提供了最优的包体积，因为只包含所需的 polyfills。

rsbuild.config.ts

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

当 output.polyfill 配置为 'entry' 时，Rsbuild 会在每个入口文件中注入 polyfills。这确保了所有 polyfills 都可用，但可能会增加包体积。

rsbuild.config.ts

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

TIP

需要注意的是，当你将页面与 Web Workers 一起打包时，由于 Web Workers 线程与主线程（页面）环境隔离，entry 方案对 Web Workers 并不适用，此时可以使用 usage 方案。

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

rsbuild.config.ts

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