Fetch API - Web API | MDN

HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
Learn web development
Get to know MDN better
此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
View in English Always switch to English
Fetch API 提供了一个用于获取资源（包括跨网络通信）的接口。它是 XMLHttpRequest 的一个更强大、更灵活的替代。
Fetch API 使用 Request 和 Response 对象（以及网络请求涉及的其他内容），还涉及 CORS 和 HTTP Origin 标头语义等相关概念。
要发起请求并获取资源，请使用 fetch() 方法。该方法在 Window 和 Worker 上下文中均为全局方法。这意味着在几乎任何需要获取资源的上下文中，都可以使用它。
fetch() 方法有一个必需参数，即要获取资源的路径。它返回一个 Promise，该 Promise 会在服务器返回头部信息后，立即解析兑现为该请求的 Response 对象——即使服务器的响应是 HTTP 错误状态。你也可以传入一个可选的 init 选项对象作为第二个参数（参见 Request）。
一旦获取到 Response 对象后，就有多种方法可用于定义主体内容以及如何处理该内容。
虽然可以直接使用 Request() 和 Response() 构造函数创建请求和响应对象，但这种做法并不常见。通常，它们会作为其他 API 操作的结果被创建（例如，来自 service worker 的 FetchEvent.respondWith()）。
有关使用 Fetch API 功能的更多信息，请参见使用 Fetch。
fetchLater() API 允许开发者请求延迟获取，它可以在指定的时间段之后发送，或者在页面关闭或导航离开时发送。参见使用延迟 Fetch。
表示响应/请求的标头信息，允许你查询这些信息，并根据结果采取不同的操作。
控制 fetchLater() API 的顶级配额。
控制 fetchLater() API 的跨源子框架共享配额。
此页面最后更新于 2026年4月17日，由 MDN 贡献者更新。
本内容的部分版权归 mozilla.org 贡献者所有，©1998–2026。内容依据知识共享许可协议提供。