Hono框架测试客户端header传递的正确方式

在Hono框架的测试过程中，开发者经常会遇到header传递不生效的问题。本文将以一个典型场景为例，深入分析问题原因并提供解决方案。

问题现象

当使用Hono的testClient进行接口测试时，按照常规方式添加headers参数：

const response = await client.index.$get({
  headers: {
    Authorization: "123",
  },
});

发现服务端无法获取到预期的Authorization头信息，导致测试失败。

根本原因

这并非框架bug，而是参数传递方式的特殊设计。Hono的testClient采用了与常规fetch不同的参数结构，需要将headers放在第二个参数对象中。

正确用法

正确的header传递方式应该是：

const response = await client.index.$get(
  {}, // 第一个参数留空或传递其他参数
  {
    headers: {
      Authorization: "123",
    },
  }
);

设计原理

这种设计源于Hono的RPC风格接口设计理念：

1. 第一个参数位置保留给路由参数
2. 第二个参数位置用于配置选项
3. 这种分离设计提高了代码的可读性和可维护性

最佳实践

对于测试场景，建议：

1. 对于简单GET请求，第一个参数可以传空对象
2. 需要同时传递查询参数和headers时：

const response = await client.user.$get(
  { id: 123 }, // 路由参数
  {
    headers: {
      Authorization: "token",
    },
  }
);

框架演进

Hono团队已经意识到文档需要更新，未来版本可能会：

1. 在测试文档中明确标注参数结构
2. 提供更直观的类型提示
3. 考虑在错误使用时给出更明确的警告信息

理解这种参数结构设计，可以帮助开发者更高效地编写Hono应用的测试代码，避免陷入header传递无效的困惑。