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

WorkerGlobalScope:fetch() 方法

· 52CE 我爱测

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

Fetch API

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

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

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

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

[!NOTE] fetch() 方法的参数与 Request.Request 构造函数是一样的。

语法

fetch(resource)
fetch(resource, options)

参数

  • resource

    • : 定义你想要获取的资源。可以是:
      • 一个字符串或任何其他具有stringifier的对象(包括 URL 对象),提供你想要获取的资源的 URL。URL 可以是相对于基础 URL 的,基础 URL 是窗口上下文中文档的 Node.baseURI 或者 worker 上下文中的 WorkerGlobalScope.location。
      • 一个 Request 对象。
  • options

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

返回值

一个 Promise,会兑现 Response 对象。

异常

  • AbortError DOMException
    • : 请求被 AbortController 的 AbortController.abort 方法调用所终止。
  • NotAllowedError DOMException
    • : 如果 Topics API 的使用被 Permissions-Policy/browsing-topics 权限策略明确禁止,且 fetch() 请求中包含 browsingTopics: true,则会抛出此异常。
  • TypeError
    • : 当获取操作无法执行时抛出的错误。请参阅 Window.fetch() 的异常,以了解可能导致此错误的原因。

示例

参见 Window.fetch 以获取示例。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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