1. 面向开发者的 Web 技术
  2. Web API
  3. WorkerGlobalScope
  4. WorkerGlobalScope：fetch() 方法

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

WorkerGlobalScope：fetch() 方法

基线 广泛可用 *

自 2017年3月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

* 此特性的某些部分的支持程度可能有所不同。

WorkerGlobalScope 接口的 fetch() 方法用于发起获取资源的请求，它会返回一个会在请求响应后兑现的 promise。

该 promise 会兑现一个表示请求响应的 Response 对象。

当请求失败（例如，因为请求 URL 的格式错误或网络错误）时，fetch() 的 promise 才会被拒绝。fetch() 的 promise 不会因为服务器响应表示错误的 HTTP 状态码（404、504，等）而被拒绝。因此，then() 处理器必须检查 Response.ok 和/或 Response.status 属性。

fetch() 方法由内容安全策略的 connect-src 指令（而不是它查询的资源的指令）控制。

备注：fetch() 方法的参数与 Request() 构造函数是一样的。

语法

js
fetch(resource)
fetch(resource, options)

参数

resource

定义你想要获取的资源。可以是：

  • 一个字符串或任何其他具有字符串化器的对象（包括 URL 对象），提供你想要获取的资源的 URL。URL 可以是相对于基础 URL 的，基础 URL 是窗口上下文中文档的 baseURI 或者 worker 上下文中的 WorkerGlobalScope.location。
  • 一个 Request 对象。
options 可选

一个包含你想要应用到请求上的任何自定义设置的 RequestInit 对象。

返回值

一个 Promise，会兑现 Response 对象。

异常

AbortError DOMException

请求被 AbortController 的 abort() 方法调用所终止。

NotAllowedError DOMException

如果 Topics API 的使用被 browsing-topics 权限策略明确禁止，且 fetch() 请求中包含 browsingTopics: true，则会抛出此异常。

TypeError

当获取操作无法执行时抛出的错误。请参阅 Window.fetch() 的异常，以了解可能导致此错误的原因。

示例

参见 fetch() 以获取示例。

规范

规范
Fetch
# fetch-method

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题