HTML怎么做PWA推送通知_HTML PWA Push推送通知实现【通俗易懂】

落杰姑娘_4173

落杰姑娘_4173

2026-04-16

570人浏览

原创

navigator.serviceworker.ready 不触发的主因是环境不满足:pwa 要求 https(localhost 除外),http 站点即使注册成功也会 pending;需确保页面通过 https:// 访问、sw 脚本路径正确且 mime 类型为 text/javascript,并尽早执行注册脚本。

html怎么做pwa推送通知_html pwa push推送通知实现【通俗易懂】

为什么 navigator.serviceWorker.ready 一直不触发?

多数人卡在这一步:注册完 Service Worker,却等不到 navigator.serviceWorker.ready Promise resolve。根本原因不是代码写错,而是环境不满足——PWA 推送通知强制要求 HTTPS(本地 localhost 除外),且页面必须通过 https:// 访问。HTTP 站点即使注册成功,serviceWorker.ready 也会 pending,后续所有推送逻辑全失效。

实操建议:

  • 开发时用 localhost 或 127.0.0.1(无需 HTTPS);上线前务必部署 HTTPS,自签名证书不行,得是受信任 CA 签发的
  • 确保注册脚本在页面加载后尽早执行,不要包裹在 window.onload 或异步模块里,避免竞态
  • 检查浏览器控制台是否有 Failed to register a ServiceWorker 错误,常见于 SW 脚本路径 404 或 MIME 类型错误(需返回 text/javascript)

如何正确调用 registration.pushManager.subscribe()?

这是获取 PushSubscription 的关键步骤,但直接调用会失败——必须先获得用户授权。Chrome、Edge 等现代浏览器已禁用自动弹窗授权,必须由用户显式触发(如点击按钮),否则抛出 DOMException: Permission denied。

实操建议:

  • 授权必须走 Notification.requestPermission(),且只在用户交互回调中调用,例如:
    button.addEventListener('click', async () => {
      const permission = await Notification.requestPermission();
      if (permission === 'granted') {
        const subscription = await registration.pushManager.subscribe({
          userVisibleOnly: true,
          applicationServerKey: urlBase64ToUint8Array('your-vapid-public-key')
        });
      }
    });
  • userVisibleOnly: true 是硬性要求,不加会报错;applicationServerKey 必须是 Uint8Array,不能直接传 Base64 字符串,需用工具函数转换(可用 crypto.subtle.importKey 或现成的 urlBase64ToUint8Array)
  • 订阅成功后,subscription.endpoint 是发送推送的唯一地址,需安全上传至服务端,别存前端 localStorage

后端发推送时为什么收到 400 Bad Request 或 410 Gone?

前端订阅成功 ≠ 后端能顺利发消息。常见问题集中在 VAPID 头和加密格式上。Web Push 协议要求每个请求带 Authorization 和 Encryption 头,缺一不可,且密钥对、盐值、公钥必须严格匹配前端订阅时用的那套。

Wechat HTML Publisher
Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载

实操建议:

  • VAPID 公钥/私钥必须成对生成,推荐用 Node.js 的 web-push 库生成:
    const webpush = require('web-push');
    webpush.generateVAPIDKeys(); // 返回 { publicKey, privateKey }
    前端用 publicKey,后端用 privateKey
  • 发送时若用 web-push.sendNotification(subscription, payload),注意 payload 长度限制:Chrome 要求加密后 ≤ 4096 字节,空载或小文本最稳;大内容建议只推通知摘要,点击再拉数据
  • 410 Gone 表示 endpoint 已失效(用户取消订阅、换设备、清缓存),服务端需监听响应状态,及时从数据库删除该订阅

Chrome 上收不到通知,但 DevTools 显示 PushEvent 已触发?

Service Worker 收到 PushEvent 并不代表通知一定弹出。真正决定是否显示的是 self.registration.showNotification() 调用,而它受限于两个隐形条件:SW 是否处于激活态、以及通知权限是否仍为 granted。

实操建议:

  • 在 SW 中监听 push 事件时,必须用 event.waitUntil() 包裹异步操作,否则事件可能被提前终止:
    self.addEventListener('push', event => {
      const data = event.data?.json() || {};
      event.waitUntil(
        self.registration.showNotification(data.title || 'New message', {
          body: data.body,
          icon: '/icon-192.png',
          badge: '/badge.png'
        })
      );
    });
  • 不要假设用户始终允许通知——每次 showNotification 前可检查 self.registration.permission,但更稳妥的做法是只在 push 事件里无条件调用,失败由系统静默处理
  • 测试时关闭 Chrome 的“暂停后台标签页”选项(chrome://flags/#automatic-tab-discarding),否则 SW 可能被休眠,导致 push 不触发

真正的难点不在代码行数,而在于每个环节都依赖前序状态:HTTPS → SW 注册 → 用户授权 → VAPID 配置 → 后端加密 → SW 激活态 → 浏览器通知策略。漏掉任意一环,都会静默失败,且错误信息极其模糊。调试时优先查 Network 面板看 push 请求响应码,再看 Application → Service Workers 的状态和日志,最后才是代码逻辑。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

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

下载

相关标签:

html

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

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5515

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3172

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2830

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2839

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4719

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2801

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2589

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2328

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2348

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 219人学习