esbuild打包浏览器端代码无法解析Node内置events模块如何处理

原因 #

events是Node.js内置核心模块，浏览器环境没有原生实现。esbuild打包浏览器目标时不会自动注入Node模块polyfill，所以会报解析失败的错误。

解决方案 #

方案1：命令行直接配置alias（适配你当前的命令行调用场景）

1. 先安装浏览器兼容版的events实现：

npm install events --save
# pnpm用户执行 pnpm add events
# yarn用户执行 yarn add events

2. 修改你的build命令，添加--alias参数映射events到已安装的兼容包：

esbuild public/js/src/main.ts --bundle --minify --sourcemap --outfile=public/js/dest/bundled.js --alias:events=events

方案2：配置文件配置（适合后续改用JS配置文件调用esbuild的场景）

在esbuild配置中添加alias字段即可，示例：

const esbuild = require('esbuild')

esbuild.build({
  entryPoints: ['public/js/src/main.ts'],
  bundle: true,
  minify: true,
  sourcemap: true,
  outfile: 'public/js/dest/bundled.js',
  alias: {
    events: 'events'
  }
}).catch(() => process.exit(1))

方案3：全量Node核心模块polyfill（如果依赖还用到了其他Node内置模块）

如果后续遇到path、util等其他Node模块解析错误，可以安装esbuild-plugin-polyfill-node插件统一处理所有Node核心模块的polyfill注入，不需要单独配置每个模块的alias。

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