通知 API

対応済みのプラットフォームでは、システム通知を表示するには、一般的に 2 つのことが必要です。まず、ユーザーが現在のオリジンに対してシステム通知を表示する許可を与える必要があります。これは一般的にアプリやサイトが初期化されたとき、 Notification.requestPermission() メソッドを使用して行われます。 このメソッドは、例えばユーザーのジェスチャーを処理する場合、マウスクリックを処理する場合などでのみ呼び出すべきです。

btn.addEventListener("click", () => {
  let promise = Notification.requestPermission();
  // wait for permission
});

これは以下のようにリクエストダイアログを起動します。

ここでは、ユーザーはこのオリジンからの通知を許可するかどうかを選択できます。一度決定がなされると、現在のセッションの間はその設定が保存されます。

次に、新しい通知は Notification() コンストラクターを使って作られます。このコンストラクターには、必須の title 引数と、オプションを指定する引数として options オブジェクトを与えることができます。オプションには、テキストの方向、本文テキスト、表示アイコン、通知サウンドなどが指定可能です。

さらに、通知 API の仕様には、いくつかのサービスワーカー API が定義されており、サービスワーカーが通知を発行できるようになっています。

Notification

通知オブジェクトを定義します。

NotificationEvent

ServiceWorker の ServiceWorkerGlobalScope に配信された通知イベントを表します。

notificationclick イベント

表示された通知をユーザーがクリックすると発生します。

notificationclose イベント

表示された通知をユーザーが閉じたときに発生します。

ServiceWorkerRegistration.getNotifications()

現在のオリジンから現在のサービスワーカー登録を経由して作成された順番で、通知の一覧を返します。

ServiceWorkerRegistration.showNotification()

リクエストされたタイトルで通知を表示します。

• 通知 API の使用