このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

PushManager: unregister() メソッド

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

メモ: この機能はウェブワーカー内で利用可能です。

unregister() メソッドは、システムに特定の端点の登録を脱退して削除するよう依頼するために使用していました。

メモ: 更新された API では、サブスクリプションは PushSubscription.unsubscribe() メソッドで脱退することができます。

構文

js
unregister(pushEndpoint)

引数

pushEndpoint

脱退する端点です。

返値

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

メソッドの呼び出しが成功した場合、リクエストの result は登録解除された端点を表す PushRegistration オブジェクトになります。

PushRegistration

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

pushEndpoint

登録解除する端点の URL を表す文字列です。

version

unregister.onsuccess が呼び出された際には undefined です。

js
const req = navigator.push.unregister(pushEndpoint);

req.onsuccess = (e) => {
  const endpoint = req.result;
  console.log(`Unregistered endpoint: ${endpoint}`);
};

req.onerror = (e) => {
  console.error(`Error unregistering the endpoint: ${e.error}`);
};

仕様書

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

ブラウザーの互換性

関連情報