dependency-wrapper 是一个关于依赖封装与依赖注入的工程实践技能,核心原则是:不要在业务逻辑中直接调用第三方库。
用途:集成第三方 API 或库;编写含外部依赖的可测试代码;构建可替换实现;管理外部服务配置;隔离供应商特定代码。
主要能力与模式:
- 简单封装:用包装模块暴露简化接口,替换库时只改该文件。示例见 date-utils 封装 date-fns。
- 工厂模式:通过 createHttpClient(config) 创建带 baseUrl、timeout、headers 配置的 HTTP 客户端。
- 适配器模式:为不同存储后端(localStorage、IndexedDB、内存)提供统一接口。
- 依赖注入:提供 Container 容器(register/get,支持 singleton)和构造函数注入(如 createUserService(httpClient))。
- 测试:用 createMockHttpClient(responses) 创建测试替身,记录调用并支持错误注入,配合 node:test 与 node:assert 编写用例。
- 常见封装:邮箱服务(console/sendgrid 等 provider)与支付服务适配器。
使用方式:在 lib/ 或 adapters/ 中创建封装模块;只暴露所需接口;用工厂函数处理配置;依赖作为构造函数参数传入;为测试创建 mock 工厂;用 JSDoc 记录公共 API;将供应商代码隔离在封装内;需要时在容器注册依赖;用 mock 实现编写测试。
限制:资料未提供安装命令、版本信息、性能或收费说明。封装会增加一层间接性,需按清单保持接口精简与文档齐全。