通知 API

要使用设置对象创建通知，给定字符串title，NotificationOptions 字典options，以及环境设置对象settings：

1. 让origin为settings的来源。

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的数据设置为StructuredSerializeForStorage(options["data"])。

5. 将notification的标题设置为title。

6. 将notification的方向设置为options["dir"]。

7. 将notification的语言设置为options["lang"]。

8. 将notification的来源设置为origin。

9. 将notification的正文设置为options["body"]。

10. 将notification的标签设置为options["tag"]。

11. 如果options["image"]存在，则使用baseURL解析它，若不返回失败，则将notification的图片URL设置为返回值。（否则不设置notification的图片URL。）

12. 如果options["icon"]存在，则使用baseURL解析它，若不返回失败，则将notification的图标URL设置为返回值。（否则不设置notification的图标URL。）

13. 如果options["badge"]存在，则使用baseURL解析它，若不返回失败，则将notification的徽章URL设置为返回值。（否则不设置notification的徽章URL。）

14. 如果options["vibrate"]存在，则验证并规范化它，并将notification的振动模式设置为返回值。

15. 如果options["timestamp"]存在，则将notification的时间戳设置为该值。否则，将notification的时间戳设置为fallbackTimestamp。

16. 将notification的重复通知偏好设置为options["renotify"]。

17. 将notification的静音偏好设置为options["silent"]。

18. 将notification的需要交互偏好设置为options["requireInteraction"]。

19. 将notification的动作设置为« »。

20. 对于options["actions"]中的每个entry，最多支持最大动作数（跳过任何多余的条目）：

    1. 让action成为新的动作。

    2. 将action的名称设置为entry["action"]。

    3. 将action的标题设置为entry["title"]。

    4. 如果entry["icon"]存在，则使用baseURL解析它，若不返回失败，则将action的图标URL设置为返回值。（否则action的图标URL保持为null。）

    5. 将action附加到notification的动作中。

21. 返回notification。

要获取通知权限状态，请执行以下步骤：

1. 将permissionState设为获取当前权限状态的结果，使用“notifications”。

2. 如果permissionState是“prompt”，则返回“default”。

3. 返回permissionState。

给定通知notification的fetch steps：

1. 如果通知平台支持图片，fetch notification的image URL（如果已设置）。

   目的是类似于使用<img>来获取此资源，但需要抽象。

   然后，并行：

   1. 等待响应。

   2. 如果响应的内部响应的类型为"default"，则尝试将资源解码为图片。

   3. 如果支持该图像格式，则将notification的image resource设置为解码后的资源。（否则notification没有image resource。）

2. 如果通知平台支持图标，fetch notification的icon URL（如果已设置）。

   目的是类似于使用<img>来获取此资源，但需要抽象。

   然后，并行：

   1. 等待响应。

   2. 如果响应的内部响应的类型为"default"，则尝试将资源解码为图片。

   3. 如果支持该图像格式，则将notification的icon resource设置为解码后的资源。（否则notification没有icon resource。）

3. 如果通知平台支持徽章，fetch notification的badge URL（如果已设置）。

   目的是类似于使用<img>来获取此资源，但需要抽象。

   然后，并行：

   1. 等待响应。

   2. 如果响应的内部响应的类型为"default"，则尝试将资源解码为图片。

   3. 如果支持该图像格式，则将notification的badge resource设置为解码后的资源。（否则notification没有badge resource。）

4. 如果通知平台支持动作和动作图标，则对于每个action，在notification的actions中：如果icon URL非空，fetch该action的icon URL。

   目的是类似于使用<img>来获取此资源，但需要抽象。

   然后，并行：

   1. 等待响应。

   2. 如果响应的内部响应的类型为"default"，则尝试将资源解码为图片。

   3. 如果支持该图像格式，则将action的icon resource设置为解码后的资源。（否则action的icon resource保持为空。）

给定通知notification的notification show steps如下：

1. 运行notification的fetch steps。

2. 等待任何fetches完成，并设置notification的image resource、icon resource和badge resource（如果有），以及notification的动作的icon resources（如果有）。

3. 设置shown为false。

4. 设置oldNotification为通知，从通知列表中找到tag不是空字符串且与notification的tag相同，且其origin与notification的origin相同的通知（如果有），否则为null。

5. 如果oldNotification非空，则：

   1. 使用oldNotification处理关闭事件。

   2. 如果通知平台支持替换，则：

      1. 在替换oldNotification为notification，在通知列表中。

      2. 设置shown为true。

      强烈建议通知平台支持原生替换，因为这可以提供更好的用户体验。

   3. 否则，移除oldNotification从通知列表。

6. 如果shown为false，则：

   1. 附加notification到通知列表。

   2. 在设备上显示notification（例如，调用适当的通知平台API）。

7. 如果shown为false或oldNotification非空，且notification的renotify偏好为true，则为notification运行提醒步骤。

8. 如果notification是非持久性通知，则排队一个任务，触发一个事件，名为show，在表示notification的Notification对象上。

当用户激活通知 notification或其中的一个动作时，假设底层通知平台支持激活，用户代理必须（除非另有说明）执行以下步骤：

1. 如果notification是持久性通知，则：

   1. 设置action为空字符串。

   2. 如果用户激活了notification的某个动作，则将action设置为该动作的名称。

   3. 触发一个名为notificationclick的服务工作者通知事件，给定notification和action。

2. 否则，排队一个任务以运行以下步骤：

   1. 设置intoFocus为触发一个名为click的事件，在表示notification的Notification对象上，且其cancelable属性被初始化为true。

      鼓励用户代理使focus()在事件监听器中工作， 针对名为click的事件。

   2. 如果intoFocus为true，则用户代理应将notification的相关浏览上下文的视口聚焦。

在整个web平台上，“激活”被故意错误命名为“点击”。

给定通知notification的关闭步骤如下：

1. 如果通知列表不包含notification，则中止这些步骤。

2. 处理关闭事件，与notification。

3. 移除notification，从通知列表中。

给定通知notification，处理关闭事件如下：

1. 如果notification是持久性通知，且notification被终端用户关闭，则触发一个服务工作者通知事件，名为"notificationclose"，给定notification。

2. 如果notification是非持久性通知，则排队一个任务，触发一个事件名为close，在表示notification的Notification对象上。

给定通知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 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 = "";
  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 icon;
};

callback NotificationPermissionCallback = undefined (NotificationPermission permission);

new Notification(title, options)构造函数的步骤如下：

1. 如果this的相关全局对象是一个ServiceWorkerGlobalScope 对象， 则抛出TypeError。

2. 如果options["actions"] 不是空的，则抛出TypeError。

   动作仅支持持久性通知。

3. 通过给定title、options和this的相关设置对象，获取创建通知与设置对象的结果notification。

4. 将notification与this关联。

5. 这些步骤并行运行：

   1. 如果获取通知权限状态的结果不是"granted"，则排队一个任务，触发一个名为error的事件，在this上，并中止这些步骤。

   2. 运行notification的通知显示步骤。

静态permission获取器步骤是返回获取通知权限状态的结果。

const permission = await navigator.permissions.query({name: "notifications"});
if (permission.state === "granted") {
// 我们有权限使用API…
}

静态requestPermission(deprecatedCallback) 方法步骤如下：

1. 令global为当前全局对象。

2. 令promise为一个新的 promise，位于this的相关领域中。

3. 并行运行以下步骤：

   1. 令permissionState为请求使用权限的结果，权限为"notifications"。

   2. 在global上排队一个全局任务，任务源为DOM操作任务源，以运行以下步骤：

      1. 如果提供了deprecatedCallback，则调用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);

实例 1                                   | 实例 2
                                             |
// 实例注意到有新邮件。                        |
new Notification("New mail from John Doe",   |
                 { tag: 'message1' });       |
                                             |
                                             |  // 稍后，此实例注意到有新邮件。
                                             |  new Notification("New mail from John Doe",
                                             |                   { tag: 'message1' });

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

// Bob 说 "你今天下午有空吗？"
new Notification("Bob: Hi / 你今天下午有空吗？", { 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 的 相关领域中。

3. 如果 this 的 激活的 worker 为 null，则拒绝 promise 并抛出 TypeError，并返回 promise。

4. 将 notification 设为 使用设置对象创建通知的结果，给定 title、 options 以及 this 的 相关设置对象。如果此操作抛出异常，则 拒绝 promise 并返回 promise。

5. 将 notification 的 服务工作者注册 设为 this。

6. 并行运行以下步骤：

   1. 如果获取通知权限状态的结果不是 "granted"，则在全局任务队列中排入任务，拒绝 promise。

   2. 为 notification 执行通知显示步骤。

   3. 在全局任务队列中排入任务以解析 promise。

7. 返回 promise。

getNotifications(filter) 方法的步骤为：

1. 将 global 设为 this 的 相关全局对象。

2. 将 realm 设为 this 的 相关领域。

3. 将 origin 设为 this 的 相关设置对象 的 来源。

4. 将 promise 设为 一个新的 promise，位于 realm。

5. 并行运行以下步骤：

   1. 将 tag 设为 filter["tag"]。

   2. 将 notifications 设为所有 列表中的 通知，这些通知的来源与 origin 为 相同来源，且其 服务工作者注册 为 this，如果 tag 不为空，则其 tag 为 tag。

   3. 在全局任务队列中排入任务，运行以下步骤：

      1. 将 objects 设为一个 列表。

      2. 对于 notifications 列表中的每个 新的 Notification 对象，附加到 objects。

      3. 解析 promise，值为 objects。

6. 返回 promise。

此方法返回 0 或更多新的 Notification 对象，这些对象可能代表已经存在的 相同底层通知。

为了触发名为 name 的 service worker 通知事件，给定 通知 notification，以及可选的字符串 action（默认为空字符串），运行 Fire Functional Event，给定 name、NotificationEvent、notification 的 service worker 注册，并初始化如下：

notification

一个新的 Notification 对象，代表 notification。

action

action

notification getter 的步骤是返回它初始化的值。

action getter 的步骤是返回它初始化的值。