HTTP 请求
请求接口是 Fetch API 的一部分,表示 fetch() 的请求。
构造函数 Jump to heading
Request() 构造函数创建一个新的 Request 实例。
let request = new Request(resource, init);
参数 Jump to heading
名称 | 类型 | 可选 | 描述 |
---|---|---|---|
resource | Request 或 USVString |
false |
资源可以是请求对象或 URL 字符串。 |
init | RequestInit |
true |
init 对象允许您设置应用于请求的可选参数。 |
返回类型是一个 Request
实例。
RequestInit
Jump to heading
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
method |
string |
GET |
请求的方法。 |
headers |
Headers 或 { [key: string]: string } |
无 | 请求的头部。 |
body |
Blob 、BufferSource 、FormData 、URLSearchParams 、USVString 或 ReadableStream |
无 | 请求的主体。 |
cache |
string |
无 | 请求的缓存模式。 |
credentials |
string |
same-origin |
请求的凭据模式。 |
integrity |
string |
无 | 请求主体的加密哈希。 |
mode |
string |
cors |
您想使用的请求模式。 |
redirect |
string |
follow |
处理重定向的模式。 |
referrer |
string |
about:client |
一个 USVString ,指定 no-referrer 、client 或一个 URL。 |
属性 Jump to heading
名称 | 类型 | 描述 |
---|---|---|
cache |
string |
缓存模式指示浏览器如何缓存请求(default 、no-cache 等)。 |
credentials |
string |
凭据(omit 、same-origin 等)指示用户代理是否在请求的 CORs 情况下发送 cookies。 |
destination |
RequestDestination |
字符串指示所请求内容的类型。 |
body |
ReadableStream |
getter 提供请求主体内容的 ReadableStream 。 |
bodyUsed |
boolean |
指示主体内容是否已被读取。 |
url |
USVString |
请求的 URL。 |
headers |
Headers |
与请求相关联的头部。 |
integrity |
string |
请求主体的加密哈希。 |
method |
string |
请求的方法(POST 、GET 等)。 |
mode |
string |
指示请求的模式(例如 cors )。 |
redirect |
string |
处理重定向的模式。 |
referrer |
string |
请求的引荐来源。 |
referrerPolicy |
string |
请求的引荐政策。 |
上述所有属性都是只读的。
方法 Jump to heading
名称 | 描述 |
---|---|
arrayBuffer() |
读取主体流直到完成并返回一个 ArrayBuffer 对象。 |
blob() |
读取主体流直到完成并返回一个 Blob 对象。 |
formData() |
读取主体流直到完成并返回一个 FormData 对象。 |
json() |
读取主体流直到完成,将其解析为 JSON 并返回一个 JavaScript 对象。 |
text() |
读取主体流直到完成并返回一个 USVString 对象(文本)。 |
clone() |
克隆请求对象。 |
示例 Jump to heading
function handler(_req) {
// 创建一个 POST 请求
const request = new Request("https://post.deno.dev", {
method: "POST",
body: JSON.stringify({
message: "Hello world!",
}),
headers: {
"content-type": "application/json",
},
});
console.log(request.method); // POST
console.log(request.headers.get("content-type")); // application/json
return fetch(request);
}
Deno.serve(handler);