JS | JS实现Web应用或网站发送浏览器Notification通知

#编程技术 2023-03-29 09:11:04 | 全文 2557 字,阅读约需 6 分钟 | 加载中... 次浏览

👋 相关阅读


今天更新了ios,发现 iOS、iPadOS 16.4 让网页应用程序也能推送通知到通知中心了,那么就来看一下如何使用 JS 通过网页发送浏览器通知吧。

在开发一个 Web 应用系统或者一个网站时,当用户触发了某个事件,或者系统想通知用户某个事件,比如有一条新的消息、其他人点赞或者评论了文章、系统流程被审核通过了等等诸如此类的场景,通常可能会想到 应用内通知 的方式,但是这种方式有一个局限,就是如果用户切换到浏览器其他页签或者其他应用程序时,可能无法及时看到应用系统的通知,那么这个时候就可以借助于浏览器的 Notification 通知功能了。

1、什么是浏览器的 Notification ?

Notification 是浏览器提供的一种允许网页向用户显示系统通知的机制,这种系统通知是在顶级浏览上下文视口之外,因此即使用户已经切换标签页或移动到不同的应用程序,也可以显示,并且 Notification 相关的 API 被设计成与不同平台上的现有通知系统兼容。

首先来看看浏览器的 Notification 通知是什么样的,这里以 SegmentFault 网站为例,只要有新用户关注或者文章被点赞收藏,SegmentFault 网站都会自动发送 Notification 通知(能看到通知的前提是要允许网站发送通知),具体通知如下:

图片alt

除了 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('允许显示系统通知')
});

图片alt

运行后,可以看到浏览器会弹出一个询问框,如下:

图片alt

不同的选择,控制台会输出不同的结果

选择【允许】后,此时再点击地址栏的信息按钮,可以看到通知已开启了,如下:

图片alt

如果不想显示通知了,可以直接在此处关闭通知即可,也可以使用下面的语句来查看当前用户的授权情况,如下:

Notification.permission

运行后,输出结果

'granted'

(2)发送系统通知

当用户允许显示系统通知后,就可以发送通知了,这时可以使用 Notification() 构造函数创建一个新通知,这个方法可以传入两个参数,具体如下:

除了上述5个常用选项外,还有其他的 badge、image、data、vibrate、renotify、requireInteraction 等,具体可查看官方网站的介绍 https://developer.mozilla.org/zh-CN/docs/Web/API/notification/Notification

下面来测试一个简单的通知,代码如下:

let notification = new Notification('有一条新通知');

这个通知只有标题,运行后,可以看到

图片alt

增加一些 options 选项,再次来测试一下系统通知,修改后的代码如下:

let notification = new Notification('有一条新通知', {
    dir: 'ltr',
    lang: 'zh-CN',
    body: '通知的正文内容:你的请假流程已批准',
    icon: 'http://localhost/coder/favicon.ico'
});

运行后,可以看到通知如下

图片alt

(3)通知事件

Notification 通知有四种事件,可以通过监听通知事件来执行不同的操作,具体事件如下:

下面来测试一下通知事件的监听,代码如下:

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');

运行后,通知的效果如下:

图片alt

via

JS实现Web应用或网站发送浏览器Notification通知 - TonyCodes http://www.archn.cn/Blog/archives/97/

Edit | Last updated on 2024-02-29 10:57:58




×