Nest.js 中如何使用 @Headers 装饰器？

推荐答案

在 Nest.js 中，@Headers 装饰器用于从 HTTP 请求头中提取特定的头信息。你可以将其用于控制器的方法参数中，以获取请求头中的特定字段或所有头信息。

使用示例

-- -------------------- ---- -------
------ - ----------- ---- ------- - ---- -----------------

----------------------
------ ----- ----------------- -
  ------
  --------------------- -------- -------------- -------- -
    ------ --------
  -

  ------------------
  ----------------------------------- ---------- ------- -
    ------ - --------- --
  -
-

解释

• @Headers() 不带参数时，会返回一个包含所有请求头的对象。
• @Headers('user-agent') 带参数时，会返回指定请求头的值。

本题详细解读

1. @Headers 装饰器的作用

@Headers 装饰器用于从 HTTP 请求中提取头信息。它可以提取单个头字段的值，也可以提取整个头对象。

2. 使用场景

• 获取特定头字段：当你只需要获取某个特定的头字段（如 user-agent）时，可以使用 @Headers('header-name')。
• 获取所有头信息：当你需要获取整个请求头对象时，可以使用 @Headers()。

3. 参数说明

• 不带参数：@Headers() 会返回一个包含所有请求头的对象，类型为 Record<string, string>。
• 带参数：@Headers('header-name') 会返回指定头字段的值，类型为 string。

4. 示例代码解析

• 获取所有头信息：

  @Get()
  getHeaders(@Headers() headers: Record<string, string>) {
    return headers;
  }

  这段代码会返回所有请求头信息。

• 获取特定头字段：

  @Get('user-agent')
  getUserAgent(@Headers('user-agent') userAgent: string) {
    return { userAgent };
  }

  这段代码会返回 user-agent 头字段的值。

5. 注意事项

• 如果请求头中不存在指定的字段，@Headers('header-name') 会返回 undefined。
• @Headers() 返回的对象是只读的，不能直接修改。

通过 @Headers 装饰器，你可以方便地获取 HTTP 请求中的头信息，并根据需要进行处理。