HTTP 请求
Request 接口是 Fetch API 的一部分,表示 fetch() 的请求。
构造函数 跳转到标题
Request() 构造函数创建一个新的 Request 实例。
let request = new Request(resource, init);
参数 跳转到标题
名称 | 类型 | 可选 | 描述 |
---|---|---|---|
资源 | Request 或 USVString |
false |
资源可以是请求对象或 URL 字符串。 |
init | RequestInit |
true |
init 对象允许您设置应用于请求的可选参数。 |
返回类型是 Request
实例。
RequestInit
跳转到标题
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
方法 |
字符串 |
GET |
请求的方法。 |
headers |
Headers 或 { [key: string]: string } |
none | 请求的 Headers。 |
body |
Blob , BufferSource , FormData , URLSearchParams , USVString , 或 ReadableStream |
none | 请求的主体。 |
cache |
字符串 |
none | 请求的缓存模式。 |
credentials |
字符串 |
same-origin |
请求的凭据模式。 |
integrity |
字符串 |
none | 请求主体的加密哈希值。 |
mode |
字符串 |
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 |
与请求关联的 headers。 |
integrity |
字符串 |
请求主体的加密哈希值。 |
方法 |
字符串 |
请求的方法 (POST , GET , 等)。 |
mode |
字符串 |
指示请求的模式 (例如 cors )。 |
redirect |
字符串 |
如何处理重定向的模式。 |
referrer |
字符串 |
请求的 referrer。 |
referrerPolicy |
字符串 |
请求的 referrer 策略 |
以上所有属性都是只读的。
方法 跳转到标题
名称 | 描述 |
---|---|
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);