在本页

HTTP 头部

The Headers 接口是 Fetch API 的一部分。它允许你创建和操作 fetch() 的请求和响应资源的 HTTP 头部。

构造函数 跳转到标题

Header() 构造函数创建一个新的 Header 实例。

let headers = new Headers(init);

参数 跳转到标题

name type optional description
init Headers / { [key: string]: string } true init 选项允许你使用现有的 Headers 或对象字面量初始化 headers 对象。

构造函数的返回类型是 Headers 实例。

方法 跳转到标题

name description
append(name: string, value: string) 将头部附加到 Headers 对象(覆盖现有头部)。
delete(name: string) 从 Headers 对象中删除头部。
set(name: string, value: string) 在 Headers 对象中创建一个新的头部。
get(name: string) 获取 Headers 对象中头部的值。
has(name: string) 检查头部是否存在于 Headers 对象中。
entries() 获取头部作为键值对。结果是可迭代的。
keys() 获取 Headers 对象的所有键。结果是可迭代的。

示例 跳转到标题

// Create a new headers object from an object literal.
const myHeaders = new Headers({
  accept: "application/json",
});

// Append a header to the headers object.
myHeaders.append("user-agent", "Deno Deploy");

// Print the headers of the headers object.
for (const [key, value] of myHeaders.entries()) {
  console.log(key, value);
}

// You can pass the headers instance to Response or Request constructors.
const request = new Request("https://api.github.com/users/denoland", {
  method: "POST",
  headers: myHeaders,
});