ServiceWorkerRegistration.getNotifications()

ServiceWorkerRegistration インターフェイスの getNotifications() メソッドは、現在のサービスワーカー登録を介して現在のオリジンから作成された順序で通知のリストを返します。 オリジンには、アクティブではあるがスコープが異なるサービスワーカー登録が多数あります。 同じオリジンの1つのサービスワーカーによって作成された通知は、同じオリジンの他のアクティブなサービスワーカーでは利用できません。

構文

s​erviceWorkerRegistration.getNotifications(options)
.then(function(notificationsList) { ... });

パラメーター

options Optional
返される通知をフィルタするオプションを含むオブジェクト。 使用可能なオプションは次のとおりです。
  • tag: 通知タグを表す DOMString。 指定した場合、このタグを持つ通知のみが返されます。

戻り値

Notification オブジェクトのリストに解決される Promise
 

navigator.serviceWorker.register('sw.js');

var options = { tag : 'user_alerts' };

navigator.serviceWorker.ready.then(function(registration) {
  registration.getNotifications(options).then(function(notifications) {
    // notifications で何かをします
  }) 
});

仕様

仕様 状態 コメント
Notifications API
ServiceWorkerRegistration.getNotifications() の定義
現行の標準 初期定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
getNotifications
実験的
Chrome 完全対応 40Edge 完全対応 17
完全対応 17
完全対応 16
無効
無効 From version 16: this feature is behind the Enable service workers preference.
Firefox 完全対応 46
補足
完全対応 46
補足
補足 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.
IE 未対応 なしOpera 完全対応 27Safari 未対応 なしWebView Android 未対応 なしChrome Android 完全対応 40Firefox Android 完全対応 46Opera Android 完全対応 27Safari iOS 未対応 なしSamsung Internet Android 完全対応 4.0

凡例

完全対応  
完全対応
未対応  
未対応
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。