Express.js res.append()函数

res.append(field [, value]) 方法在响应头中添加一个新的字段值对。如果该字段已经存在，该方法会将新值添加到已存在的值之后。

语法

res.append(field [, value])

参数

• field：一个字符串或一个对象，表示 HTTP 头字段的名称或一个包含字段名称和值的对象。
• value (可选)：表示字段值的字符串或一个数组。

返回值

该方法没有返回值。

示例

以下是一个基本的使用示例：

app.get('/', function (req, res) {
  res.append('Cache-Control', 'no-cache')
  res.send('Hello World!')
})

在这个例子中，我们使用 res.append() 方法添加了一个 Cache-Control 字段，该字段的值为 no-cache。之后，我们调用 res.send() 函数向客户端发送一个 "Hello World" 的响应。

多个值

您还可以向同一字段添加多个值，通过将值作为数组传递给 value 参数。

以下是一个例子：

res.append('Set-Cookie', ['type=ninja', 'language=javascript']);

在这个例子中，我们将两个 cookie 添加到响应头中。

规范化

当您向响应头添加字段值时，Express 会自动规范化字段名称并将多个值合并到单个头字段中。该规范化过程会将字段的大写字母转换为小写，并用连字符 - 连接单词。

以下是一个例子：

res.append('Cache-Control', 'no-cache')
// 相当于调用：
res.set('Cache-Control', 'no-cache')

结论

res.append() 方法为 Express 框架提供了向响应头添加新字段的功能。您可以使用该方法添加单个或多个值到已存在或新创建的 HTTP 头字段。这一功能对于控制响应行为（如缓存）和通信协议（如 cookie）非常有用。