Node侧Fetch兼容
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/dek20265908。
技能介绍
脚本里最不起眼的那个坑
团队里的导出、同步脚本,运行时往往是被 CI 拉起来的 Node 进程,而不是带浏览器引擎的环境。这段脚本要调 CRM 的 API、要把 JSON 落盘,听起来简单,但一旦 Node 版本偏旧,全局就没有 fetch;为了保险引入 node-fetch,又会撞上仓库里另一个依赖已经锁的 node-fetch@3,最后两个版本被装在同一个 node_modules 里,请求行为不一致,排错成本远高于收益。
这个技能解决的就是这件事:让脚本侧有一个统一的请求入口,不依赖宿主 Node 版本,也不把版本冲突带进项目。
它是怎么工作的
核心实现灵感来自轻量库 node-fetch-native,它本身不追求包下一切,而是在 Node 环境里做最贴近原生的取值。技能在此基础上约定了一套工程化的用法:
- 脚本入口统一收口到
fetchJson,业务代码只关心 URL,不关心底层是谁在发。 - 有原生就用原生:当宿主 Node 已经提供
fetch时直接复用,避免多余一层包装和内存占用。 - 旧版 Node 走兼容实现,保证脚本在各种 CI 镜像里都能跑起来。
- 关键实现的注释位置标注 小四原创,便于阅读时区分设计意图和上游行为。
自测方式也很朴素:在 Node 下请求本地 mock,验证成功路径能拿到数据,失败路径能拿到明确的状态码,而不是吞掉异常。
边界与注意点
它不是一个中台式的 HTTP 客户端,所以:
- 不做完整的重试、拦截器、请求编排——这些需求应该继续用
ofetch,浏览器或前端打包场景也优先原生fetch或ofetch,不要把整包塞进前端 bundle。 - 严禁混装
node-fetch@2与node-fetch@3,这也是引入该技能最主要的动机。 - 依赖锁定在
node-fetch-native,不要自行替换底层实现。
总结一句:它是给工具脚本用的一行 fetch,不是给应用架构用的一坨封装。
使用场景
- 在CRM导出脚本里调用API获取客户数据,并成功将JSON格式结果落盘存储。
- 开发citty CLI命令行工具时,需要在Node进程内发送HTTP请求获取指标数据。
- 当Node.js项目升级遇到node-fetch@2与@3混装冲突时,统一脚本入口以修复。
- 在缺乏原生fetch支持的旧版Node环境运行工具脚本时,依然能正常发请求。
适合人员
- 负责编写数据同步脚本的后端开发者,寻求稳定且无依赖冲突的HTTP请求方案。
- 开发citty CLI工具的工程人员,需要在Node侧快速发起轻量级网络请求。
- 需要维护旧版Node.js环境运行自动化脚本的技术负责人,希望避免全局fetch缺失问题。