Skip to main content
On this page

HTTP 请求

2026年7月20日停止服务

Deno Deploy Classic 将于 2026年7月20日关闭。我们建议迁移 到新的 Deno Deploy 平台。详情请参见 迁移指南

Request 接口是 Fetch API 的一部分,表示 fetch() 的请求。

构造函数 Jump to heading

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

let request = new Request(resource, init);

参数 Jump to heading

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

返回类型是一个 Request 实例。

RequestInit Jump to heading
name type default description
method string GET 请求的方法。
headers Headers{ [key: string]: string } 请求的头信息。
body BlobBufferSourceFormDataURLSearchParamsUSVStringReadableStream 请求的主体。
cache string 请求的缓存模式。
credentials string same-origin 请求的凭据模式。
integrity string 请求主体的加密哈希。
mode string cors 您要使用的请求模式。
redirect string follow 处理重定向的方式。
referrer string about:client 指定 no-referrerclient 或 URL 的 USVString

属性 Jump to heading

名称 类型 描述
cache string 缓存模式指示浏览器应如何缓存该请求(defaultno-cache 等)。
credentials string 凭据(omitsame-origin 等)指示在请求发生 CORS 时,用户代理是否应发送 cookie。
destination RequestDestination 该字符串指示所请求内容的类型。
body ReadableStream 该 getter 暴露了请求体内容的 ReadableStream
bodyUsed boolean 指示请求体内容是否已被读取。
url USVString 请求的 URL。
headers Headers 与该请求关联的标头。
integrity string 请求体的加密哈希值。
method string 请求的方法(POSTGET 等)。
mode string 指示请求的模式(例如 cors)。
redirect string 指示如何处理重定向的模式。
referrer string 请求的 referrer。
referrerPolicy string 请求的 referrer policy。

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

方法 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: "你好,世界!",
    }),
    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);

Last updated on

Did you find what you needed?

编辑此页面
Privacy policy