大网数据广告活动
Web 标准与前端开发

Notification:requestPermission() 静态方法

· 52CE 我爱测

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

Web Notifications

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

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

语法

Notification.requestPermission()

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

参数

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

返回值

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

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

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

示例

假设如下基本的 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 请求通知权限,并且其他浏览器也将效仿。要查看实际示例,请查看我们的待办事项列表示例(参见实时运行用例)。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。