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

Fetch API

· 52CE 我爱测

Fetch API 提供了一个用于获取资源(包括跨网络通信)的接口。它是 XMLHttpRequest 的一个更强大、更灵活的替代。

Fetch API

Fetch API 提供了一个用于获取资源(包括跨网络通信)的接口。它是 XMLHttpRequest 的一个更强大、更灵活的替代。

概念和用法

Fetch API 使用 Request 和 Response 对象(以及网络请求涉及的其他内容),还涉及 CORS 和 HTTP Origin 标头语义等相关概念。

要发起请求并获取资源,请使用 Window/fetch 方法。该方法在 Window 和 WorkerGlobalScope 上下文中均为全局方法。这意味着在几乎任何需要获取资源的上下文中,都可以使用它。

fetch() 方法有一个必需参数,即要获取资源的路径。它返回一个 Promise,该 Promise 会在服务器返回头部信息后,立即解析兑现为该请求的 Response 对象——即使服务器的响应是 HTTP 错误状态。你也可以传入一个可选的 init 选项对象作为第二个参数(参见 Request)。

一旦获取到 Response 对象后,就有多种方法可用于定义主体内容以及如何处理该内容。

虽然可以直接使用 Request.Request 和 Response.Response 构造函数创建请求和响应对象,但这种做法并不常见。通常,它们会作为其他 API 操作的结果被创建(例如,来自 service worker 的 FetchEvent.respondWith())。

有关使用 Fetch API 功能的更多信息,请参见使用 Fetch。

延迟 Fetch

Window/fetchLater API 允许开发者请求延迟获取,它可以在指定的时间段之后发送,或者在页面关闭或导航离开时发送。参见使用延迟 Fetch。

接口

  • Window.fetch() 和 WorkerGlobalScope.fetch()
    • : 用于获取资源的 fetch() 方法。
  • Window.fetchLater()
    • : 用于发起延迟获取请求。
  • DeferredRequestInit
    • : 表示可用于配置延迟获取请求的选项集合。
  • FetchLaterResult
    • : 表示请求延迟获取的结果。
  • Headers
    • : 表示响应/请求的标头信息,允许你查询这些信息,并根据结果采取不同的操作。
  • Request
    • : 表示资源请求。
  • Response
    • : 表示对请求的响应。

HTTP 标头

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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