HTTP 请求

请求 接口是 Fetch API 的一部分，代表了 fetch() 的请求。

• 构造函数
  • 参数
• 属性
• 方法
• 示例

构造函数

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

let request = new Request(input, init);

参数

名称	类型	可选	描述
资源	Request 或 USVString	false	资源可以是请求对象或 URL 字符串。
初始化	RequestInit	true	初始化对象允许您设置应用于请求的可选参数。

返回类型是 Request 实例。

RequestInit

名称	类型	默认值	描述
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	指定 no-referrer、client 或 URL 的 USVString 引用。

属性

名称	类型	描述
cache	string	缓存模式指示浏览器应该如何缓存请求（default、no-cache 等）。
credentials	string	凭据（omit、same-origin 等）指示用户代理是否应在请求的跨源情况下发送 cookie。
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	请求的引用策略。

所有上述属性都是只读的。

方法

名称	描述
arrayBuffer()	读取正文流直到完成并返回一个 ArrayBuffer 对象。
blob()	读取正文流直到完成并返回一个 Blob 对象。
formData()	读取正文流直到完成并返回一个 FormData 对象。
json()	读取正文流直到完成，将其解析为 JSON 并返回一个 JavaScript 对象。
text()	读取正文流直到完成并返回一个 USVString 对象（文本）。
clone()	克隆 Request 对象。

示例

import { serve } from "https://deno.land/std@0.208.0/http/server.ts";

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);
}

serve(handler);