Node.js实验性fetch与node-fetch库是否存在破坏性差异？

核心破坏性差异点 #

• 全局可用性与导入方式
  Node.js实验性全局fetch无需导入，可直接在代码中调用；而node-fetch必须通过require或import语句导入后才能使用，直接全局调用会抛出引用错误。
• API 构造函数的作用域
  全局fetch的Request、Response、Headers等构造函数属于全局作用域，可直接实例化；node-fetch的这些构造函数需要从包中导出使用，比如import { Request, Response } from 'node-fetch'，直接全局使用会找不到变量。
• FormData 实现差异
  全局fetch使用Node.js内置的FormData API，而node-fetch依赖第三方form-data包的实现，两者在append、get等方法的参数处理上存在细微差异，比如内置FormData不支持部分额外的文件名参数格式，迁移时可能导致表单数据提交异常。
• HTTP 状态码的Promise处理
  node-fetch v2版本默认会对HTTP 4xx/5xx状态码的请求抛出Promise拒绝，而全局fetch遵循浏览器标准，仅在网络层面出错时才会拒绝Promise，HTTP错误状态码仍会resolve。虽然node-fetch v3之后调整为和浏览器一致，但如果项目依赖旧版，迁移到全局fetch时需要修改错误处理逻辑。
• 启动与兼容性限制
  Node.js v18中全局fetch需要通过--experimental-fetch启动参数开启，v20之后才默认启用；node-fetch无启动参数要求，在更低版本的Node.js中也能稳定运行。
• 底层配置差异
  全局fetch基于undici库实现，node-fetch v3之后也基于undici，但两者的请求配置项（比如超时、代理）的设置方式不同。例如全局fetch的超时需通过AbortController实现，而旧版node-fetch支持直接传入timeout参数。

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