envoi调用方只拿 T。

一个与框架无关的 HTTP response layer。业务状态码、hooks 和 adapters 配置一次，所有 API 都暴露 Promise。

运行在线 Demo

安装与配置

返回契约只写一次
HTTP status、业务 code、字段改名和自定义 error 都放进带类型的 envelope。
Transport 可以替换
transport 不做隐式选择，axios、fetch、ofetch 和自定义 adapter 接收相同的规范化请求。
调试路径明确
hooks 暴露生命周期，raw 保留 status、headers、blob 和底层 response。

场景Envelope 成功解包 data

后端 responseOK

HTTP 200

{
  "status": 200,
  "body": {
    "code": 200,
    "msg": "ok",
    "data": {
      "id": 42,
      "name": "Ada"
    }
  }
}

envoi 输出—

等待运行

// 运行后在这里查看 resolve 值或 BizError

一个客户端，四层职责

const instance = createAxiosInstance({ withCredentials: true });
const http = createHttp({
  adapter: axiosAdapter(instance),
  defaults: { baseURL: "/api", timeout: 15_000 },
  envelope: { code: "code", msg: "msg", data: "data" },
  hooks: { onRequest: auth(getToken), onResponseError: showError },
});

01request hookslifecycle

02adaptertransport

03response policyprotocol

04Promise<T>consumer

request hooks 准备请求，adapter 执行 HTTP，项目选择的 response policy 产出 Promise<T>。应用状态仍由调用方管理。

可以直接落到项目里的案例

01 / 完整案例搭建生产客户端

一份代码串起认证、语言、业务状态码、query function、文件下载和渐进迁移。

02 / 返回协议定义 response contract

覆盖 HTTP-only 默认行为、显式 envelope、字段改名、自定义 error 和预期失败 body。

03 / Transport保持 adapters 可替换

baseURL、query、timeout 和错误规则由统一层处理，adapter 只负责发送请求。

重复逻辑开始影响行为时再引入

只有两三个普通请求的项目可以继续使用 fetch 或 axios。多个接口或多个应用需要统一 response 解构、业务失败、公共 headers、adapter 行为和调用方返回值时，envoi 才开始节省维护成本。

端到端案例从一份可以上线的客户端开始。

查看完整案例 →

envoi调用方只拿 T。

返回契约只写一次

Transport 可以替换

调试路径明确

一个客户端，四层职责 ​

可以直接落到项目里的案例 ​

重复逻辑开始影响行为时再引入 ​

一个客户端，四层职责

可以直接落到项目里的案例

重复逻辑开始影响行为时再引入