iOS16.4版Safari的ServiceWorker无PushManager，原因何在？

关键排查与解决步骤 #

• 必须将 PWA 添加到主屏幕
  iOS Safari 的 Web Push 仅对已添加到主屏幕的 PWA开放，未完成此操作时，ServiceWorkerRegistration不会暴露pushManager接口。这是iOS的硬性限制，哪怕Service Worker已激活也无效，必须手动完成添加主屏幕的操作。

• 确保符合安全环境要求
  虽然你当前用localhost调试（iOS允许localhost豁免HTTPS），但如果是真机测试非本地服务，必须使用HTTPS协议。iOS对Web Push的安全校验严格，非HTTPS环境下PushManager接口不会生效。

• 检查 Service Worker 注册范围
  确认Service Worker的注册路径和范围是否覆盖当前页面。可以通过显式指定注册范围确保匹配，示例代码：

  navigator.serviceWorker.register('/sw.js', { scope: '/' })
  

• 绑定权限请求到用户主动交互
  iOS要求必须在用户主动操作（如点击按钮）时请求通知权限，不能在页面加载时自动触发。否则权限请求会被拦截，导致PushManager无法初始化。示例实现：

  document.getElementById('enable-push-btn').addEventListener('click', async () => {
    const permission = await Notification.requestPermission();
    if (permission === 'granted') {
      const registration = await navigator.serviceWorker.ready;
      const pushManager = registration.pushManager;
      // 执行后续推送逻辑
    }
  });
  

• 等待 Service Worker 完全就绪
  必须等Service Worker进入activated状态后再尝试访问pushManager，建议使用navigator.serviceWorker.ready等待就绪，避免直接获取未激活的实例：

  navigator.serviceWorker.ready.then(registration => {
    if ('pushManager' in registration) {
      // 正常使用PushManager
    } else {
      console.error('PushManager 不可用');
    }
  });
  

• 处理 iOS 16.4 已知兼容性问题
  iOS 16.4作为Web Push的首个支持版本，存在一些小缺陷：

  • 首次添加到主屏幕打开PWA时，PushManager可能未暴露，需关闭PWA后重新打开。
  • 通知权限弹窗可能延迟出现，可尝试再次触发权限请求。

内容的提问来源于stack exchange，提问作者Joshua S