HTTP 请求
Request
接口是 Fetch API 的一部分,它代表 fetch() 的请求。
构造函数 跳转到标题
Request()
构造函数创建一个新的 Request 实例。
let request = new Request(resource, init);
参数 跳转到标题
名称 | 类型 | 可选 | 描述 |
---|---|---|---|
resource | Request 或 USVString |
false |
资源可以是请求对象,也可以是 URL 字符串。 |
init | RequestInit |
true |
init 对象允许您设置应用于请求的可选参数。 |
返回类型是 Request
实例。
RequestInit
跳转到标题
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
method |
字符串 |
GET |
请求的方法。 |
headers |
Headers 或 { [key: string]: string } |
无 | 请求的请求头。 |
body |
Blob , BufferSource , FormData , URLSearchParams , USVString , 或 ReadableStream |
无 | 请求体。 |
cache |
字符串 |
无 | 请求的缓存模式。 |
credentials |
字符串 |
same-origin |
请求的凭据模式。 |
integrity |
字符串 |
无 | 请求体的加密哈希值。 |
模式 |
字符串 |
cors |
您想使用的请求模式。 |
redirect |
字符串 |
follow |
重定向的处理模式。 |
referrer |
字符串 |
about:client |
一个 USVString ,指定 no-referrer 、client 或一个 URL。 |
属性 跳转到标题
名称 | 类型 | 描述 |
---|---|---|
cache |
字符串 |
缓存模式指示浏览器应如何缓存请求(如 default 、no-cache 等)。 |
credentials |
字符串 |
凭据(如 omit 、same-origin 等)指示用户代理在请求跨域(CORS)时是否应发送 cookie。 |
destination |
RequestDestination |
该字符串指示所请求内容的类型。 |
body |
ReadableStream |
此 getter 暴露了请求体内容的 ReadableStream 。 |
bodyUsed |
布尔值 |
指示请求体内容是否已被读取。 |
url |
USVString |
请求的 URL。 |
headers |
Headers |
与请求关联的请求头。 |
integrity |
字符串 |
请求体的加密哈希值。 |
method |
字符串 |
请求的方法(如 POST 、GET 等)。 |
模式 |
字符串 |
指示请求的模式(例如 cors )。 |
redirect |
字符串 |
重定向的处理模式。 |
referrer |
字符串 |
请求的引用者。 |
referrerPolicy |
字符串 |
请求的引用者策略。 |
以上所有属性均为只读。
方法 跳转到标题
名称 | 描述 |
---|---|
arrayBuffer() |
读取请求体流直到完成,并返回一个 ArrayBuffer 对象。 |
blob() |
读取请求体流直到完成,并返回一个 Blob 对象。 |
formData() |
读取请求体流直到完成,并返回一个 FormData 对象。 |
json() |
读取请求体流直到完成,将其解析为 JSON 并返回一个 JavaScript 对象。 |
text() |
读取请求体流直到完成,并返回一个 USVString 对象(文本)。 |
clone() |
克隆 Request 对象。 |
示例 跳转到标题
function handler(_req) {
// Create a post request
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);