PushManager: registrations() メソッド

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

registrations メソッドは、プッシュ通知の端点登録の存在に関してシステムに問い合わせするために使用します。

メモ: このメソッドは PushManager.getSubscription() メソッドに置き換えられました。

構文

js
registrations()

引数

なし。

返値

DOMRequest オブジェクトで、このメソッド呼び出しの成功または失敗を扱います。

メソッドの呼び出しが成功した場合、リクエストの result は PushRegistration オブジェクトの配列になります。

PushRegistration

このオブジェクトは無名の JavaScript オブジェクトで、以下のプロパティがあります。

pushEndpoint

端点の URL を表す文字列です。

version

プッシュ通知の端点の現在のバージョンです。

例

js
const req = navigator.push.registrations();

req.onsuccess = (e) => {
  if (req.result.length > 0) {
    req.result.forEach((result) => {
      console.log(
        `Existing registration ${result.pushEndpoint} ${result.version}`,
      );
    });
    // Reuse existing endpoints.
  } else {
    // Register for a new endpoint.
    const register = navigator.push.register();
    register.onsuccess = (e) => {
      console.log(`Registered new endpoint: ${register.result}`);
    };
  }
};

仕様書

この機能はもうどの仕様にも属していません。標準化の予定はなくなりました。

ブラウザーの互換性

BCD tables only load in the browser

関連情報