在开发一个Web应用系统或者一个网站时,当用户触发了某个事件,或者系统想通知用户某个事件,比如有一条新的消息、其他人点赞或者评论了文章、系统流程被审核通过了等等诸如此类的场景,通常可能会想到 应用内通知 的方式,但是这种方式有一个局限,就是如果用户切换到浏览器其他页签或者其他应用程序时,可能无法及时看到应用系统的通知,那么这个时候就可以借助于浏览器的 Notification 通知功能了。
1、什么是浏览器的 Notification ?
Notification 是浏览器提供的一种允许网页向用户显示系统通知的机制,这种系统通知是在顶级浏览上下文视口之外,因此即使用户已经切换标签页或移动到不同的应用程序,也可以显示,并且 Notification 相关的 API 被设计成与不同平台上的现有通知系统兼容。
首先来看看浏览器的 Notification 通知是什么样的,这里以 SegmentFault 网站为例,只要有新用户关注或者文章被点赞收藏,SegmentFault 网站都会自动发送 Notification 通知(能看到通知的前提是要允许网站发送通知),具体通知如下:
除了 SegmentFault 网站外,还可以看看网页版微信的系统通知,也是类似的。
2、如何使用 Notification ?
要显示一个系统通知,一般需要分成两步:用户授予显示通知的权限、发送系统通知。
(1)用户授予显示通知的权限
系统要给用户发送通知,如果用户不想查看这个通知,即没有授予相应的权限,那么即使通知发出了,用户也是无法看到的。
如何向用户询问是否允许查看系统通知的权限呢?可以使用下面的方法
Notification.requestPermission()
该方法的返回值有三个:granted、denied、default,最新的规范已将此方法更新为基于 promise 的语法,工作原理如下:
Notification.requestPermission().then(function(permission) { ... });
下面来看一个具体的实例,在 localhost 上询问显示系统通知的权限,根据不同的选择结果,打印相应的日志信息,代码如下:
Notification.requestPermission().then(function(result) {
if (result === 'denied') {
console.log('拒绝显示系统通知');
return;
}
if (result === 'default') {
console.log('默认');
return;
}
console.log('允许显示系统通知')
});
按下F12,打开 Chrome 的控制台,复制上面的代码
运行后,可以看到浏览器会弹出一个询问框,如下:
不同的选择,控制台会输出不同的结果
- 允许:控制台会输出 允许显示系统通知,如果选择了允许,再次请求权限时,不会再弹出选择框,而是在控制台直接输出允许显示系统通知;
- 禁止:控制台会输出 拒绝显示系统通知,如果选择了拒绝,再次请求权限时,不会再弹出选择框,而是在控制台直接输出拒绝显示系统通知;;
- x关闭:控制台会输出 默认,如果直接关闭了,再次请求权限时,依然会弹出选择框;
选择【允许】后,此时再点击地址栏的信息按钮,可以看到通知已开启了,如下:
如果不想显示通知了,可以直接在此处关闭通知即可,也可以使用下面的语句来查看当前用户的授权情况,如下:
Notification.permission
运行后,输出结果
'granted'
(2)发送系统通知
当用户允许显示系统通知后,就可以发送通知了,这时可以使用 Notification() 构造函数创建一个新通知,这个方法可以传入两个参数,具体如下:
title(必传)
- 定义一个通知的标题,当它被触发时,它将显示在通知窗口的顶部。
options(可选)
options 对象包含应用于通知的任何自定义设置选项,常用的选项有:
dir
: 文字的方向;它的值可以是auto(自动)
,ltr(从左到右)
, orrtl
(从右到左);lang
: 指定通知中所使用的语言。这个字符串必须在 BCP 47 language tag 文档中是有效的;body
: 通知中额外显示的字符串;tag
: 赋予通知一个 ID,以便在必要的时候对通知进行刷新、替换或移除;icon
: 一个图片的 URL,将被用于显示通知的图标;
除了上述5个常用选项外,还有其他的 badge、image、data、vibrate、renotify、requireInteraction 等,具体可查看官方网站的介绍 https://developer.mozilla.org/zh-CN/docs/Web/API/notification/Notification
下面来测试一个简单的通知,代码如下:
let notification = new Notification('有一条新通知');
这个通知只有标题,运行后,可以看到
增加一些 options 选项,再次来测试一下系统通知,修改后的代码如下:
let notification = new Notification('有一条新通知', {
dir: 'ltr',
lang: 'zh-CN',
body: '通知的正文内容:你的请假流程已批准',
icon: 'http://localhost/coder/favicon.ico'
});
(3)通知事件
Notification 通知有四种事件,可以通过监听通知事件来执行不同的操作,具体事件如下:
- Notification.onclick:对 click 事件的处理,每当用户点击通知时被触发;
- Notification.onshow:对 show 事件的处理,当通知显示的时候被触发;
- Notification.onerror:对 error 事件的处理,每当通知遇到错误时被触发;
- Notification.onclose:对 close 事件的处理,当用户关闭通知时被触发。
下面来测试一下通知事件的监听,代码如下:
let notification = new Notification('有一条新通知', {
dir: 'ltr',
lang: 'zh-CN',
body: '通知的正文内容:你的请假流程已批准',
icon: 'http://localhost/coder/favicon.ico'
});
// 监听通知显示事件
notification.onshow = () => console.log('通知已显示');
// 监听通知点击事件
notification.onclick = () => console.log('通知被点击');
// 监听通知被关闭事件
notification.onclose = () => console.log('通知被关闭');
// 监听通知错误事件
notification.onerror = () => console.log('通知出现错误');
运行时,控制台会直接输出如下信息
通知已显示
点击通知时,会输出
通知被点击
当通知关闭时,会输出
通知被关闭
3、发送Notification通知代码
结合上面的介绍,下面给出发送通知的参考代码,具体如下:
function sendNotification(title, body, icon, callback) {
// 先检查浏览器是否支持
if (!('Notification' in window)) {
// IE浏览器不支持发送Notification通知!
return;
}
if (Notification.permission === 'denied') {
// 如果用户已拒绝显示通知
return;
}
if (Notification.permission === 'granted') {
//用户已授权,直接发送通知
notify();
} else {
// 默认,先向用户询问是否允许显示通知
Notification.requestPermission(function(permission) {
// 如果用户同意,就可以直接发送通知
if (permission === 'granted') {
notify();
}
});
}
function notify() {
let notification = new Notification(title, {
icon: icon,
body: body
});
notification.onclick = function() {
callback && callback();
console.log('单击通知框')
}
notification.onclose = function() {
console.log('关闭通知框');
};
}
}
下面来测试一下:
sendNotification('下班通知', '今天周五,还有十分钟下班', 'http://localhost/coder/favicon.ico');
运行后,通知的效果如下:
参考资料: