PushManager.getSubscription()

PushManager インターフェースの PushManager.getSubscription() メソッドは、既存のプッシュサブスクリプションを取得します。

これは既存のプッシュサブスクリプションの詳細を含む PushSubscription を解決する Promise を返します。既存のプッシュサブスクリプションが存在しない場合 null 値で解決されます。

構文

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

パラメーター

なし。

戻り値

PushSubscription オブジェクトで解決される Promise。

例

このコードスニペットは、push messaging and notification sample から取ってきました（使用できるライブデモはありません）。

// サブスクリプションをチェックするために、service worker の登録が必要である。
  navigator.serviceWorker.ready.then(function(serviceWorkerRegistration) {
    // 既にプッシュメッセージサブスクリプションがあるか？
    serviceWorkerRegistration.pushManager.getSubscription()
      .then(function(subscription) {
        // プッシュメッセージからサブスクライブ ／ アンサブスクライブ
        // する任意の UI を有効にする
        var pushButton = document.querySelector('.js-push-button');
        pushButton.disabled = false;

        if (!subscription) {
          // プッシュを購読していない場合、ユーザーがプッシュできるように
          // UI を設定する。
          return;
        }

        // 最新の subscriptionId でサーバ同期を維持する。
        sendSubscriptionToServer(subscription);
        
        showCurlCommand(subscription);

        // プッシュメッセージの購読を表示するために
        // UI を設定する。
        pushButton.textContent = 'Disable Push Messages';
        isPushEnabled = true;
      })
      .catch(function(err) {
        window.Demo.debug.log('Error during getSubscription()', err);
      });
  });
}

仕様

ブラウザ実装状況

• [1] Push（と Service Workers）は、 have been disabled in the Firefox 45 延長サポート版 （ESR）では使用できません。
• [2] Firefox for Android 48 から、既定で Push を使用できます。

関連項目

• Using the Push API