ParcelJS不打包导入的ping-monitor库，Cloudflare Worker运行报require未定义

根因说明 #

• Cloudflare Worker 运行环境仅支持 ES 模块规范，不支持 Node.js 原生 CommonJS 的 require 语法。你遇到的 require is not defined 错误，本质是Parcel没有正确识别运行环境，将第三方依赖的 CommonJS 导入语句直接保留在了产物中，没有把 ping-monitor 打包进最终产物。
• 你使用的动态导入写法 const Monitor = import('ping-monitor') 也会触发Parcel的代码拆分逻辑，导致依赖没有合并到单文件产物内。

修复步骤 #

1. 调整导入语法 #

将动态导入改为静态ES导入，确保Parcel识别到需要全量打包的依赖：

// 替换原有导入语句
import Monitor from 'ping-monitor'

2. 指定打包目标环境 #

两种方式二选一即可：

• 方式一：在 package.json 中添加 browserslist 配置，强制Parcel输出兼容Worker环境的ES模块

{
  "browserslist": ["last 2 chrome versions", "maintained node versions"]
}

• 方式二：直接在打包命令中指定输出格式为ES模块

parcel build src/index.ts --target esmodule

3. 配置Node原生模块polyfill（可选） #

ping-monitor 依赖Node原生的 net、dgram 模块实现ping能力，Cloudflare Worker默认不支持这些模块，需要配置polyfill：
首先在 package.json 中添加别名配置：

{
  "alias": {
    "net": "browserify-net",
    "dgram": "browserify-dgram"
  }
}

然后安装对应polyfill依赖：

npm install --save-dev browserify-net browserify-dgram

4. 清理缓存重新打包 #

删除旧的缓存和产物，避免缓存影响打包结果：

rm -rf dist .parcel-cache
# 执行打包
parcel build src/index.ts --target esmodule

打包完成后检查产物，确认不存在 require("ping-monitor") 语句后，再用 wrangler dev 启动验证即可。

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