# web.header

## 功能

设置一个或一组响应头。

## 语法

```bt
web.header(key, value)
web.header(headers)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| key | String | 否 | 无 | 响应头名称。 |
| value | Any | 否 | 无 | 响应头值。 |
| headers | Object | 否 | 无 | 响应头映射对象；键和值的规则见下方。 |

## headers 对象结构

| 键 | 值类型 | 说明 |
| ------ | ------ | ------ |
| 响应头名称 | Any | 响应头值；调用时会转为字符串写入 HTTP 响应头。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Bool | 设置成功返回 true。 |

## 示例

```bt
// 使用方式一：设置单个响应头。
web.header('Content-Type', 'text/plain; charset=utf-8')

// 使用方式二：一次设置多个响应头。
result = web.header({
    'Content-Type': 'text/plain; charset=utf-8',
    'Access-Control-Allow-Origin': '*'
})

// 输出：true
print result
```

## 注意事项

- 只能在 Web 请求中调用。
- 参数必须是对象或 key/value。