trembita-http-client

分类: 开发与编程 | 上传者: oleg-koval | 下载: 0 | 版本: v1.0（最新）

使用基于结果的错误处理、重试和断路器模式与 trembita 构建弹性、类型安全的 HTTP 集成。 --- # Trembita 技能 使用此存储库作为代理使用“trembita”实现 HTTP 客户端的实用参考。 ## 何时使用 - 为第三方 REST API 构建 TypeScript 集成。 - 添加强大的错误处理，无需异常驱动的控制流。 - 以最小的依赖性实现重试、断路器和超时。 - 通过注入 `fetchImpl` 编写可测试的 API 代码。 ## 核心模式 1. 使用 `createTrembita()` 初始化一次并处理 init `Result`。 2. 使用 client.request() 来解析 JSON 正文响应。 3. 当需要 HTTP 元数据（“statusCode”、“body”）时，使用“client.client()”。 4. 通过检查 `result.error.kind` 缩小失败范围。 5. 通过 `createRetryingFetch` 和 `CircuitBreaker` 配置添加弹性。 ## 规范参考 - `README.md` - 快速概述和安装。 - `QUICK_START.md` - 第一次成功的最短路径。 - `LEARNING_GUIDE.md` - 概念和渐进示例。 - `EXAMPLES.md` - 生产风格模式。 - `ARCHITECTURE.md` - 请求/错误流程图。 ## Agent Guardrails - 对于请求结果，更喜欢使用“Result”处理而不是“try/catch”。 - 保持端点配置明确并经过验证。 - 首选“expectedCodes”来记录可接受的 HTTP 结果。 - 使用 `client.client()` 通过状态代码进行 404/202 分支。 - 在测试中注入`fetchImpl`；避免全局获取修补。

更新日志: Source: GitHub https://github.com/oleg-koval/trembita