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

Response

· 52CE 我爱测

你可以使用 Response.Response() 构造函数来创建一个 `Response` 对象,但通常更可能遇到的情况是,其他的 API 操作返回了一个 Response 对象。例如一个 service worker 的 Fetchevent.respondWith,或者一个简单的 GlobalFetch.fetch()。

Fetch API

Fetch API 的 Response 接口呈现了对一次请求的响应数据。

你可以使用 Response.Response() 构造函数来创建一个 Response 对象,但通常更可能遇到的情况是,其他的 API 操作返回了一个 Response 对象。例如一个 service worker 的 Fetchevent.respondWith,或者一个简单的 GlobalFetch.fetch()。

构造函数

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

属性

  • Response.headers
    • : 包含此 Response 所关联的 Headers 对象。
  • Response.ok
    • : 包含了一个布尔值,标示该 Response 成功(HTTP 状态码的范围在 200-299)。
  • Response.redirected
    • : 表示该 Response 是否来自一个重定向,如果是的话,它的 URL 列表将会有多个条目。
  • Response.status
    • : 包含 Response 的状态码(例如 200 表示成功)。
  • Response.statusText
    • : 包含了与该 Response 状态码一致的状态信息(例如,OK 对应 200)。
  • Response.type
    • : 包含 Response 的类型(例如,basic、cors)。
  • Response.url
    • : 包含 Response 的 URL。
  • Response.useFinalURL
    • : 包含了一个布尔值,来标示这是否是该 Response 的最终 URL。

Response 实现了 Body 接口,所以以下属性亦可用:

  • Response.body
    • : 一个简单的 getter,用于暴露一个 ReadableStream 类型的 body 内容。
  • Response.bodyUsed
    • : 包含了一个Boolean来标示该 Response 是否读取过 Body。

方法

  • Response.clone()
    • : 创建一个 Response 对象的克隆。
  • Response.error()
    • : 返回一个绑定了网络错误的新的 Response 对象。
  • Response.redirect()
    • : 用另一个 URL 创建一个新的 Response。

Response 实现了 Body 接口,所以以下方法同样可用:

  • Body.arrayBuffer()
    • : 读取 Response 对象并且将它设置为已读(因为 Responses 对象被设置为了 stream 的方式,所以它们只能被读取一次),并返回一个被解析为 ArrayBuffer 格式的 Promise 对象。
  • Body.blob()
    • : 读取 Response 对象并且将它设置为已读(因为 Responses 对象被设置为了 stream 的方式,所以它们只能被读取一次),并返回一个被解析为 Blob 格式的 Promise 对象。
  • Body.formData()
    • : 读取Response 对象并且将它设置为已读(因为 Responses 对象被设置为了 stream 的方式,所以它们只能被读取一次),并返回一个被解析为 FormData 格式的 Promise 对象。
  • Body.json()
    • : 读取 Response 对象并且将它设置为已读(因为 Responses 对象被设置为了 stream 的方式,所以它们只能被读取一次),并返回一个被解析为 JSON 格式的 Promise 对象。
  • Body.text()
    • : 读取 Response 对象并且将它设置为已读(因为 Responses 对象被设置为了 stream 的方式,所以它们只能被读取一次),并返回一个被解析为 String 格式的 Promise 对象。

示例

在我们的基础实例 (点击运行) 中,我们使用了一个简单的函数调用,调用了 fetch() 函数来获取一张图片并将其显示在 HTML 的 IMG 标签中,fetch() 函数返回了一个 Promise,它使用与资源获取操作相关联的 Response 对象进行解析。你会注意到,由于我们正在请求一张图片,我们需要运行 Body.blob(Response 实现了),以为响应提供正确的 MIME 类型。

const image = document.querySelector(".my-image");
fetch("flowers.jpg")
  .then(function (response) {
    return response.blob();
  })
  .then(function (blob) {
    const objectURL = URL.createObjectURL(blob);
    image.src = objectURL;
  });

你也可以使用 Response.Response() 这样的构造方法,来创建自定义的 Response 对象:

const response = new Response();

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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