Notification：requestPermission() 静态方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

Notification 接口的 requestPermission() 静态方法向用户为当前来源请求显示通知的权限。

该方法返回一个 Promise，会兑现一个表示是否授予或拒绝权限的字符串。

语法

Notification.requestPermission()

// 弃用的使用回调的语法
Notification.requestPermission(callback)

参数

callback 可选已弃用: 一个可选的参数为权限请求的结果的回调函数。此参数已废弃，请使用 Promise 返回值的语法。

返回值

一个 Promise，会兑现为一个表示用户选择的权限的字符串。该字符串的可能值为：

granted: 用户已明确授予当前源显示系统通知的权限。
denied: 用户已明确拒绝当前源显示系统通知的权限。
default: 用户决定未知；在这种情况下，应用程序的行为就像权限被“拒绝”一样。

该方法的弃用版本返回 undefined。

示例

假设如下基本的 HTML：

html

<button onclick="notifyMe()">通知我！</button>

可以按如下方式发送通知——这里我们提供了一组相当详细和完整的代码，如果你想首先检查是否支持通知，然后检查是否已授予当前域名发送通知的权限，然后，如果必需的话，在发送通知前请求权限。

请注意，请求应当响应用户交互：下面，该方法在鼠标单击事件处理器中被调用。

function notifyMe() {
  if (!("Notification" in window)) {
    // 检查浏览器是否支持桌面通知
    alert("此浏览器不支持桌面通知");
  } else if (Notification.permission === "granted") {
    // 检查通知权限是否已经被授予；如果是的话，创建一条通知
    const notification = new Notification("你好呀！");
    // …
  } else if (Notification.permission !== "denied") {
    // 我们需要请求用户的许可
    Notification.requestPermission().then((permission) => {
      // 如果用户同意，让我们创建一个通知
      if (permission === "granted") {
        const notification = new Notification("你好呀！");
        // …
      }
    });
  }

  // 最后，如果用户拒绝了通知，而你想要尊重他们，就没有必要再打扰他们了。
}

我们不再在此页面上展示实时示例，因为 Chrome 和 Firefox 不再允许从跨源 <iframe> 请求通知权限，并且其他浏览器也将效仿。要查看实际示例，请查看我们的待办事项列表示例（参见实时运行用例）。

规范

Specification
Notifications API Standard # dom-notification-requestpermission

浏览器兼容性

BCD tables only load in the browser

参见

使用 Notification API