大网数据广告活动
Web 标准与前端开发

Request

· 52CE 我爱测

你可以使用 Request.Request 构造函数创建一个新的 `Request` 对象,但是你更可能会遇到作为其他 API 操作结果返回的 Request 对象,比如 service worker 的 FetchEvent.request。

Fetch API

Fetch API 的 Request 接口用来表示资源请求。

你可以使用 Request.Request 构造函数创建一个新的 Request 对象,但是你更可能会遇到作为其他 API 操作结果返回的 Request 对象,比如 service worker 的 FetchEvent.request。

构造函数

  • Request.Request
    • : 创建一个新的 Request 对象。

实例属性

  • Request.body
    • : 主体内容的 ReadableStream。
  • Request.bodyUsed
    • : 存储 true 或 false,以指示请求是否仍然未被使用。
  • Request.cache
    • : 包含请求的缓存模式(例如,default、reload、no-cache)。
  • Request.credentials
    • : 包含请求的凭据(例如,omit、same-origin、include)。默认是 same-origin。
  • Request.destination
    • : 返回一个描述请求的目的字符串。这是一个字符串,指示所请求的内容类型。
  • Request.headers
    • : 包含请求相关联的 Headers 对象。
  • Request.integrity
    • : 包含请求的子资源完整性值(例如 sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=)。
  • Request.method
    • : 包含请求的方法(GET、POST 等)。
  • Request.mode
    • : 包含请求的模式(例如,cors、no-cors、same-origin、navigate)。
  • Request.redirect
    • : 包含如何处理重定向的模式。它可能是 follow、error 或 manual 之一。
  • Request.referrer
    • : 包含请求的 referrer(例如,client)。
  • Request.referrerPolicy
    • : 包含请求的 referrer 策略(例如,no-referrer)。
  • Request.signal
    • : 返回与请求相关联的 AbortSignal。
  • Request.url
    • : 包含请求的 URL。

实例方法

  • Request.arrayBuffer()
    • : 返回 promise,其兑现值为请求主体的 ArrayBuffer 表示形式。
  • Request.blob()
    • : 返回 promise,其兑现值为请求主体的 Blob 表示形式。
  • Request.clone()
    • : 创建一个当前 Request 对象的副本。
  • Request.formData()
    • : 返回 promise,其兑现值为请求主体的 FormData 表示形式。
  • Request.json()
    • : 返回 promise,其兑现值为请求主体经过 JSON 解析的结果。
  • Request.text()
    • : 返回 promise,其兑现值为请求主体的文本表示形式。

[!NOTE] 这些请求主体上的函数只能运行一次,随后的调用将出现 TypeError 错误,表明请求主体流已被使用。

示例

在下面的代码中,我们使用 Request() 构造函数创建了一个新的请求(用来请求与脚本处于同一目录下的图片),然后返回请求的一些属性:

const request = new Request("https://www.mozilla.org/favicon.ico");

const url = request.url;
const method = request.method;
const credentials = request.credentials;

然后,通过将 Request 对象作为参数传递给 fetch() 调用来获取此请求,例如:

fetch(request)
  .then((response) => response.blob())
  .then((blob) => {
    image.src = URL.createObjectURL(blob);
  });

在下面的代码片段中,我们使用 Request() 构造函数创建了一个新的请求,其中包含一些初始数据和主体内容,用于需要主体有效载荷的 API 请求:

const request = new Request("https://example.com", {
  method: "POST",
  body: '{"foo": "bar"}',
});

const url = request.url;
const method = request.method;
const credentials = request.credentials;
const bodyUsed = request.bodyUsed;

[!NOTE] body 只能是一个 Blob、ArrayBuffer、TypedArray、DataView、FormData、URLSearchParams、ReadableStream 或 String 对象,也可以是一个字符串字面量,因此增加一个 JSON 对象的有效载荷则需要字符串化该对象。

然后,通过将 Request 对象作为参数传递给 fetch() 调用来获取此请求,并取得响应,例如:

fetch(request)
  .then((response) => {
    if (response.status === 200) {
      return response.json();
    } else {
      throw new Error("Something went wrong on API server!");
    }
  })
  .then((response) => {
    console.debug(response);
    // …
  })
  .catch((error) => {
    console.error(error);
  });

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。