PushManager.getSubscription()

Baseline 2023
Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

PushManager 接口的方法**PushManager.getSubscription()** 尝试获取已有的推送订阅。

它返回一个 Promise 用来 resolve 出一个包含现有订阅的详细信息的PushSubscription 对象。如果不存在已有的推送订阅,返回 null。

语法

js
PushManager.getSubscription().then(function(pushSubscription) { ... } );

参数

无。

返回值

A Promise that resolves to a PushSubscription object or null.

例子

这个代码片段来自 push messaging and notification sample. (没有能直接运行的例子.)

js
// We need the service worker registration to check for a subscription
navigator.serviceWorker.ready.then(function (serviceWorkerRegistration) {
  // Do we already have a push message subscription?
  serviceWorkerRegistration.pushManager
    .getSubscription()
    .then(function (subscription) {
      // Enable any UI which subscribes / unsubscribes from
      // push messages.
      var pushButton = document.querySelector(".js-push-button");
      pushButton.disabled = false;

      if (!subscription) {
        // We aren’t subscribed to push, so set UI
        // to allow the user to enable push
        return;
      }

      // Keep your server in sync with the latest subscriptionId
      sendSubscriptionToServer(subscription);

      showCurlCommand(subscription);

      // Set your UI to show they have subscribed for
      // push messages
      pushButton.textContent = "Disable Push Messages";
      isPushEnabled = true;
    })
    .catch(function (err) {
      window.Demo.debug.log("Error during getSubscription()", err);
    });
});

规范

Specification
Push API
# dom-pushmanager-getsubscription

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getSubscription

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.