通知API

設定オブジェクトで通知を作成するには、文字列 title、 NotificationOptions 辞書 options、および environment settings object settingsを受け取って行います：

1. originをsettingsの originとします。

2. baseURLをsettingsの APIベースURLとします。

3. fallbackTimestampを、Unixエポックから settingsの現在の壁時間までのミリ秒数（最も近い整数に丸める）とします。

4. 通知を作成する処理を、title、 options、origin、baseURL、fallbackTimestampを渡して実行し、その結果を返します。

通知を作成するには、文字列 title、 NotificationOptions 辞書 options、origin origin、URL baseURL、EpochTimeStamp fallbackTimestampを受け取って行います：

1. notificationを新しい通知とします。

2. もしoptions["silent"] がtrueであり、 options["vibrate"] 存在する場合、TypeErrorをスローします。

3. もしoptions["renotify"] がtrueであり、 options["tag"] が空文字列の場合、TypeErrorをスローします。

4. notificationのdataを StructuredSerializeForStorage(options["data"])の結果に設定します。

5. notificationのtitleをtitleに設定します。

6. notificationのdirectionを options["dir"]に設定します。

7. notificationのlanguageを options["lang"]に設定します。

8. notificationのoriginをoriginに設定します。

9. notificationのbodyを options["body"]に設定します。

10. もしoptions["navigate"] 存在する場合、それをbaseURLでパースし、失敗しない場合は notificationのnavigation URLにその値を設定します。（失敗した場合、notificationのnavigation URLはnullのままです。）

11. notificationのtagを options["tag"]に設定します。

12. もしoptions["image"] 存在する場合、それをbaseURLでパースし、失敗しない場合は notificationのimage URLにその値を設定します。（失敗した場合、notificationのimage URLは設定しません。）

13. もしoptions["icon"] 存在する場合、それをbaseURLでパースし、失敗しない場合は notificationのicon URLにその値を設定します。（失敗した場合、notificationのicon URLは設定しません。）

14. もしoptions["badge"] 存在する場合、それをbaseURLでパースし、失敗しない場合は notificationのbadge URLにその値を設定します。（失敗した場合、notificationのbadge URLは設定しません。）

15. もしoptions["vibrate"] 存在する場合、バリデートおよび正規化し、 notificationの vibration patternにその値を設定します。

16. もしoptions["timestamp"] 存在する場合は notificationのtimestampにその値を設定します。そうでない場合は notificationのtimestampにfallbackTimestampを設定します。

17. notificationのrenotify preferenceを options["renotify"]に設定します。

18. notificationのsilent preferenceを options["silent"]に設定します。

19. notificationのrequire interaction preferenceを options["requireInteraction"]に設定します。

20. notificationのactionsを« »に設定します。

21. options["actions"]の各entryについて、 サポートされるアクションの最大数まで（余分なエントリーはスキップ）：

    1. actionを新しい通知アクションとします。

    2. actionのnameを entry["action"]に設定します。

    3. actionのtitleを entry["title"]に設定します。

    4. もしentry["navigate"] 存在する場合、それをbaseURLでパースし、失敗しない場合は actionのnavigation URLにその値を設定します。 （失敗した場合、actionのnavigation URLはnullのままです。）

    5. もしentry["icon"] 存在する場合、それをbaseURLでパースし、失敗しない場合は actionのicon URLにその値を設定します。（失敗した場合、actionのicon URLはnullのままです。）

    6. actionをnotificationのactionsに追加します。

22. notificationを返します。

通知権限状態を取得するためには、以下の手順を実行します：

1. permissionStateを"notifications"を使って 現在の権限状態を取得する結果とします。

2. もしpermissionStateが"prompt"の場合、"default"を返します。

3. permissionStateを返します。

ある通知 notificationに対するフェッチ手順は以下の通りです：

1. 通知プラットフォームが画像をサポートしている場合、フェッチ notificationのimage URL（image URLが設定されている場合）。

   このリソースは <img> のようにフェッチする意図ですが、抽象化が必要です。

   その後、並行して：

   1. レスポンスを待つ。

   2. レスポンスの内部レスポンスのtypeが"default"の場合、そのリソースを画像としてデコードを試みる。

   3. 画像フォーマットがサポートされていれば、notificationのimage resourceにデコード済みリソースを設定する。（そうでなければ notificationはimage resourceを持たない。）

2. 通知プラットフォームがアイコンをサポートしている場合、フェッチ notificationのicon URL （icon URLが設定されている場合）。

   このリソースは <img> のようにフェッチする意図ですが、抽象化が必要です。

   その後、並行して：

   1. レスポンスを待つ。

   2. レスポンスの内部レスポンスのtypeが"default"の場合、そのリソースを画像としてデコードを試みる。

   3. 画像フォーマットがサポートされていれば、notificationのicon resourceにデコード済みリソースを設定する。（そうでなければ notificationはicon resourceを持たない。）

3. 通知プラットフォームがバッジをサポートしている場合、フェッチ notificationのbadge URL （badge URLが設定されている場合）。

   このリソースは <img> のようにフェッチする意図ですが、抽象化が必要です。

   その後、並行して：

   1. レスポンスを待つ。

   2. レスポンスの内部レスポンスのtypeが"default"の場合、そのリソースを画像としてデコードを試みる。

   3. 画像フォーマットがサポートされていれば、notificationのbadge resourceにデコード済みリソースを設定する。（そうでなければ notificationはbadge resourceを持たない。）

4. 通知プラットフォームがアクションおよびアクションアイコンをサポートしている場合、notificationのactions内の各actionについて：icon URLがnullでない場合、フェッチ actionのicon URL。

   このリソースは <img> のようにフェッチする意図ですが、抽象化が必要です。

   その後、並行して：

   1. レスポンスを待つ。

   2. レスポンスの内部レスポンスのtypeが"default"の場合、そのリソースを画像としてデコードを試みる。

   3. 画像フォーマットがサポートされていれば、actionのicon resourceにデコード済みリソースを設定する。（そうでなければ actionのicon resourceはnullのまま。）

指定された通知 notificationの通知表示手順は以下の通りです：

1. notificationについてフェッチ手順を実行します。

2. すべてのフェッチが完了し、notificationの image resource、 icon resource、 badge resource （存在する場合）、および notificationのactionsの icon resources （存在する場合）がセットされるのを待ちます。

3. shownをfalseとします。

4. oldNotificationを、通知のリストの中から tagが空文字列でなく、 notificationのtagと一致し、 originが notificationのoriginと同一オリジンであるもの（存在しない場合はnull）とします。

5. oldNotificationがnullでない場合：

   1. oldNotificationに対してクローズイベント処理を行います。

   2. 通知プラットフォームが置換をサポートしている場合：

      1. 通知リストで oldNotificationを notificationに置き換えます。

      2. shownをtrueに設定します。

      通知プラットフォームは、ネイティブの置換をサポートすることが強く推奨されます。これはユーザー体験の向上につながります。

   3. それ以外の場合、通知リストから oldNotificationを削除します。

6. shownがfalseの場合：

   1. 通知リストに notificationを追加します。

   2. デバイス上にnotificationを表示します（例：通知プラットフォームAPIを呼び出すなど）。

7. shownがfalse、またはoldNotificationがnullでない場合で、 notificationのrenotify preferenceがtrueであれば、 notificationについてアラート手順を実行します。

8. notificationが非永続的通知の場合、 タスクをキューして Notification オブジェクト（notificationを表す）にshowイベントを 発火します。

ユーザーが通知プラットフォームのアクティブ化をサポートしている場合、通知 notification またはその actions のいずれかがエンドユーザーによってアクティブ化されたとき、ユーザーエージェントは（他に指定がない限り）以下の手順を実行しなければなりません：

1. actionをnullとします。

2. エンドユーザーがnotificationのactionsのいずれかをアクティブ化した場合、actionにその 通知アクションを設定します。

3. navigationURLをnotificationの navigation URLとします。

4. actionがnullでない場合、navigationURLをactionの notification action navigation URLに設定します。

   この仕様により、通知アクションの navigation URLがnullの場合は clickイベントにフォールスルーし、ウェブ開発者により柔軟性を提供します。

5. navigationURLがnullでない場合：

   1. 実装定義の方法で次のいずれかを選択します：

      • ユーザーエージェントのトップレベルトラバーサブル集合内の既存の トップレベルトラバーサブルを navigationURLにナビゲートする。

      • 新しいトップレベルトラバーサブルを作成し、navigationURLを指定する。

      ユーザーエージェントはプラットフォームの慣習に合わせることが強く推奨されます。

   2. 終了します。

6. notificationが永続的通知の場合：

   1. actionNameを空文字列とします。

   2. actionがnullでない場合、actionNameにactionの nameを設定します。

   3. notificationclickという名前でサービスワーカー通知イベントを発火します。notificationとactionNameを指定します。

7. それ以外の場合、タスクをキューして以下の手順を実行します：

   1. intoFocusを Notification オブジェクト（notificationを表す）のclickイベントを 発火し、その cancelable 属性をtrueで初期化した結果とします。

      ユーザーエージェントは、focus() がclickイベントリスナー内で動作するようにすることが推奨されます。

   2. intoFocusがtrueの場合、ユーザーエージェントは notificationの関連するブラウジングコンテキストのビューポートをフォーカスすべきです。

ウェブプラットフォーム全体で「activate」は意図的に「click」と誤称されています。

指定された通知 notificationのクローズ手順は以下の通りです：

1. 通知のリストがnotificationを含まない場合、これらの手順を中止します。

2. notificationに対してクローズイベント処理を行います。

3. 通知のリストから notificationを削除します。

指定された通知 notificationに対してクローズイベント処理を行うには：

1. notificationが永続的通知であり、かつ notificationがエンドユーザーによってクローズされた場合、"notificationclose"という名前でサービスワーカー通知イベントを発火します。notificationを指定します。

2. notificationが非永続的通知の場合、 タスクをキューして Notification オブジェクト（notificationを表す）にcloseイベントを 発火します。

指定された通知 notificationについてエンドユーザーにアラートを行うアラート手順は以下の通りです：

1. notificationのバイブレーションパターン（存在する場合）を用いて バイブレーションを実行します。

[Exposed=(Window,Worker)]
interface Notification : EventTarget {
  constructor(DOMString title, optional NotificationOptions options = {});

  static readonly attribute NotificationPermission permission;
  [Exposed=Window] static Promise<NotificationPermission> requestPermission(optional NotificationPermissionCallback deprecatedCallback);

  static readonly attribute unsigned long maxActions;

  attribute EventHandler onclick;
  attribute EventHandler onshow;
  attribute EventHandler onerror;
  attribute EventHandler onclose;

  readonly attribute DOMString title;
  readonly attribute NotificationDirection dir;
  readonly attribute DOMString lang;
  readonly attribute DOMString body;
  readonly attribute USVString navigate;
  readonly attribute DOMString tag;
  readonly attribute USVString image;
  readonly attribute USVString icon;
  readonly attribute USVString badge;
  [SameObject] readonly attribute FrozenArray<unsigned long> vibrate;
  readonly attribute EpochTimeStamp timestamp;
  readonly attribute boolean renotify;
  readonly attribute boolean? silent;
  readonly attribute boolean requireInteraction;
  [SameObject] readonly attribute any data;
  [SameObject] readonly attribute FrozenArray<NotificationAction> actions;

  undefined close();
};

dictionary NotificationOptions {
  NotificationDirection dir = "auto";
  DOMString lang = "";
  DOMString body = "";
  USVString navigate;
  DOMString tag = "";
  USVString image;
  USVString icon;
  USVString badge;
  VibratePattern vibrate;
  EpochTimeStamp timestamp;
  boolean renotify = false;
  boolean? silent = null;
  boolean requireInteraction = false;
  any data = null;
  sequence<NotificationAction> actions = [];
};

enum NotificationPermission {
  "default",
  "denied",
  "granted"
};

enum NotificationDirection {
  "auto",
  "ltr",
  "rtl"
};

dictionary NotificationAction {
  required DOMString action;
  required DOMString title;
  USVString navigate;
  USVString icon;
};

callback NotificationPermissionCallback = undefined (NotificationPermission permission);

new Notification(title, options) コンストラクタの手順は以下の通りです：

1. thisの関連グローバルオブジェクトがServiceWorkerGlobalScope オブジェクトの場合、 TypeErrorをスローします。

2. options["actions"] が空でない場合、 TypeErrorをスローします。

   アクションは永続的通知のみでサポートされます。

3. notificationを、 設定オブジェクトで通知を作成する手順の title、options、 thisの関連設定オブジェクトを引数として実行した結果とします。

4. thisをnotificationと関連付けます。

5. 並行して以下の手順を実行します：

   1. 通知権限状態を取得する結果が "granted"でない場合、 タスクをキューして thisにerrorイベントを発火し、 これらの手順を中止します。

   2. notificationについて通知表示手順を実行します。

静的permissionゲッターの手順は、通知の権限状態を取得するの結果を返します。

const permission = await navigator.permissions.query({name: "notifications"});
if (permission.state === "granted") {
   // APIの利用権限があります…
}

静的 requestPermission(deprecatedCallback) メソッドの手順は以下の通りです：

1. globalを現在のグローバルオブジェクトとします。

2. promiseを新しいPromiseとして、thisの関連Realmで生成します。

3. 並行して以下の手順を実行します：

   1. permissionStateを "notifications"の利用権限を要求する結果とします。

   2. DOM操作タスクソース上でglobalに対してグローバルタスクをキューし、以下の手順を実行します：

      1. deprecatedCallbackが与えられていれば、コールバック関数を呼び出す （引数は« permissionState »と"report"）。

      2. promiseをpermissionStateで解決します。

4. promiseを返します。

var not = new Notification("Gebrünn Gebrünn by Paul Kalkbrenner", { icon: "newsong.svg", tag: "song" });
not.onclick = function() { displaySong(this); };

self.registration.showNotification("New mail from Alice", {
  actions: [{action: 'archive', title: "Archive"}]
});

self.addEventListener('notificationclick', function(event) {
  event.notification.close();
  if (event.action === 'archive') {
    silentlyArchiveEmail();
  } else {
    clients.openWindow("/inbox");
  }
}, false);

Instance 1                                   | Instance 2
                                             |
// Instance notices there is new mail.       |
new Notification("New mail from John Doe",   |
                 { tag: 'message1' });       |
                                             |
                                             |  // Slightly later, this instance notices
                                             |  // there is new mail.
                                             |  new Notification("New mail from John Doe",
                                             |                   { tag: 'message1' });

// Bob says "Hi"
new Notification("Bob: Hi", { tag: 'chat_Bob' });

// Bob says "Are you free this afternoon?"
new Notification("Bob: Hi / Are you free this afternoon?", { tag: 'chat_Bob' });

dictionary GetNotificationOptions {
  DOMString tag = "";
};

partial interface ServiceWorkerRegistration {
  Promise<undefined> showNotification(DOMString title, optional NotificationOptions options = {});
  Promise<sequence<Notification>> getNotifications(optional GetNotificationOptions filter = {});
};

[Exposed=ServiceWorker]
interface NotificationEvent : ExtendableEvent {
  constructor(DOMString type, NotificationEventInit eventInitDict);

  readonly attribute Notification notification;
  readonly attribute DOMString action;
};

dictionary NotificationEventInit : ExtendableEventInit {
  required Notification notification;
  DOMString action = "";
};

partial interface ServiceWorkerGlobalScope {
  attribute EventHandler onnotificationclick;
  attribute EventHandler onnotificationclose;
};

showNotification(title, options) メソッドの手順は以下の通りです：

1. globalをthisの関連グローバルオブジェクトとします。

2. promiseを新しいPromiseとして、thisの関連Realmで生成します。

3. thisのactive workerがnullなら、 promiseをTypeErrorでrejectし、promiseを返します。

4. notificationを 設定オブジェクトで通知を作成する手順で title, options, thisの関連設定オブジェクトを渡して作成した結果とします。例外が発生した場合は promiseをその例外でrejectし、promiseを返します。

5. notificationのservice worker registrationを thisに設定します。

6. 並行して以下の手順を実行します：

   1. 通知権限状態を取得する結果が "granted"でない場合、 DOM操作タスクソース上でglobalに対してグローバルタスクをキューし、 promiseをTypeErrorでreject し、これらの手順を中止します。

   2. notificationについて通知表示手順を実行します。

   3. notificationのservice worker registrationの showNotification()が正常に呼び出されたか をtrueにします。

   4. DOM操作タスクソース上でglobalに対してグローバルタスクをキューし、 promiseをundefinedでresolve します。

7. promiseを返します。

getNotifications(filter) メソッドの手順は以下の通りです：

1. globalをthisの関連グローバルオブジェクトとします。

2. realmをthisの関連Realmとします。

3. originをthisの関連設定オブジェクトの originとします。

4. promiseを新しいPromiseとしてrealmで生成します。

5. 並行して以下の手順を実行します：

   1. tagをfilter["tag"]とします。

   2. notificationsを、リストとして、 通知のリスト内で originが originと同一オリジンであり、 service worker registrationがthisであるもの、 かつtagが空文字列でない場合はtagがtagであるもの のすべての通知とします。

   3. DOM操作タスクソース上でglobalに対してグローバルタスクをキューし、以下の手順を実行します：

      1. objectsをリストとして初期化します。

      2. notificationsの各notificationについて、作成順に realmでその通知を表す新しいNotification オブジェクトを作成し、objectsに追加します。

      3. promiseをobjectsでresolveします。

6. promiseを返します。

このメソッドは、新しいNotification オブジェクトを0個以上返します。返されたオブジェクトは、すでに存在しているNotificationオブジェクトが表すものと同じ 基礎となる通知を表す場合があります。

サービスワーカー通知イベントを発火するには、名前name、notification notification、オプションの文字列action（デフォルトは空文字列）を受け取り、Fire Functional Eventをname、NotificationEvent、 notificationのservice worker registration、および次の初期化で実行します：

notification

新しいNotificationオブジェクトでnotificationを表す。

action

action

notificationゲッターの手順は、初期化時の値を返すことです。

actionゲッターの手順は、初期化時の値を返すことです。