JavaScript 中 fetch 怎么在 ServiceWorker 中拦截处理

冬婷同学_8076

冬婷同学_8076

2026-09-16

560人浏览

原创

serviceworker 拦截 fetch 请求需监听 fetch 事件并调用 event.respondwith() 返回响应;注册须同源、https,激活后生效;仅拦截同源请求,不可读 opaque 响应;注意缓存策略与 clone 前校验 bodyused。

javascript 中 fetch 怎么在 serviceworker 中拦截处理

在 ServiceWorker 中拦截并处理 fetch 请求,核心是监听全局的 fetch 事件,并在事件回调中调用 event.respondWith() 返回自定义响应。这不同于页面中的 fetch 调用,ServiceWorker 是通过事件机制“劫持”所有经过它的网络请求(包括页面 fetchXMLHttpRequest、资源加载等)。

注册并激活 ServiceWorker

确保 ServiceWorker 已正确注册且处于 activated 状态,否则 fetch 事件不会触发:

  • 注册脚本需与页面同源,通常在主 JS 中调用 navigator.serviceWorker.register('/sw.js')
  • sw.js 文件必须是 HTTPS(或 localhost),且响应状态码为 200
  • 首次注册后需刷新页面,或调用 skipWaiting() + clients.claim() 加速激活

监听 fetch 事件并返回响应

sw.js 中监听 fetch 事件,用 event.respondWith() 拦截请求:

Generate HVAC Service Company Client Education Handout
Generate HVAC Service Company Client Education Handout

清晰、专业的暖通空调服务客户教育手册,包含图片、常见问题及可操作的下一步,帮助客户理解并提升参与度。

下载
  • event.request 是只读的 Request 对象,可读取 URL、method、headers 等
  • 必须调用 event.respondWith(promise),否则请求会失败(报 TypeError: Failed to fetch
  • 返回值可以是缓存响应(cache.match())、网络响应(fetch(event.request))、或全新构造的 Response

示例:优先返回缓存,缓存未命中则走网络

self.addEventListener('fetch', event => {
  const url = new URL(event.request.url);
  
  // 可选:跳过某些请求(如第三方资源、导航请求)
  if (url.origin !== location.origin || event.request.destination === 'document') {
    return;
  }

  event.respondWith(
    caches.match(event.request).then(cached => {
      if (cached) return cached;
      return fetch(event.request).then(response => {
        // 可选:将响应存入缓存(注意非 GET 请求通常不缓存)
        if (response.status === 200 && event.request.method === 'GET') {
          const cache = await caches.open('my-cache');
          cache.put(event.request, response.clone());
        }
        return response;
      });
    })
  );
});

注意跨域与请求限制

ServiceWorker 的 fetch 拦截有明确边界:

  • 仅拦截同源请求(event.request.url 与 SW 脚本同源),除非使用 navigationPreloadimportScripts 加载跨域资源(但不能直接拦截)
  • 无法拦截 opaque 响应(如跨域无 CORS 的图片/脚本),其 response.type'opaque',且 headers/body 不可读
  • 导航请求(destination === 'document')默认不被缓存,需显式处理(例如用 navigationPreload 或返回 fallback HTML)

调试与常见陷阱

开发时建议开启 Chrome 的 “Update on reload” 和 “Bypass for network”,并在 Application → Service Workers 面板中检查状态:

  • 忘记调用 event.respondWith() → 请求卡住或失败
  • respondWith() 中抛出未捕获错误 → 请求失败,控制台显示 unhandled rejection
  • 对 POST/PUT 等请求直接缓存响应 → 可能导致数据不一致,应谨慎判断是否缓存
  • 使用 response.clone() 前未确认 response.bodyUsed === false → 报错 “Failed to execute 'clone' on 'Response': Response body is already used”

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4026

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1029

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

3904

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

820

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1696

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

2965

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

3853

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2440

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

808

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.8万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习