今天專案基本都提測完了,趁著空檔寫兩篇記錄。上一篇《如何搭建 node 工程》想必有需要的讀者已經看過。這篇要展示的效果相當實用——在頁面右下角跳出作業系統層級的通知訊息——因此特別記錄下來,方便日後回頭查閱。
套路一樣,我們一步一步來,思路會比較清楚。
先看效果。注意右下角出現的彈出訊息,這正是我們要實作的:

第一步:先搭一個架子
以下程式碼都寫在 script 標籤內,只要關注 script 標籤裡的內容即可:
<!DOCTYPE html>
<html>
<head lang="en">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta charset="utf-8">
<meta content="" name="description">
<meta content="" name="keywords">
<meta content="eric.wu" name="author">
<meta content="application/xhtml+xml;charset=UTF-8" http-equiv="Content-Type">
<meta property="qc:admins" />
<meta content="telephone=no, address=no" name="format-detection">
<meta content="width=device-width, initial-scale=1.0, minimum-scale=1.0,
maximum-scale=1.0, user-scalable=no" name="viewport">
<title>消息推送實例</title>
</head>
<body>
查看右下角,的消息通知..........
</body>
</html>
<script type="text/javascript">
</script>
第二步:檢測瀏覽器是否支援 Web Notifications API
這一步是必要的入場檢查——只有支援這個 API,後續的一切才有意義。
function justify_notifyAPI(){
if (window.Notification) {
// 支援
console.log("支援" + "Web Notifications API");
} else {
// 不支援
console.log("不支援" + "Web Notifications API");
}
}
第三步:檢測瀏覽器是否允許彈出通知
這裡要先向使用者請求權限。若使用者曾經按下「封鎖」,後續建立通知的嘗試都會失敗,因此這個判斷不可省略。(圖片位址換成自己的即可)
function justify_showMess(){
if (window.Notification && Notification.permission !== "denied") {
Notification.requestPermission(function(status) {
if (status === "granted") {
var n = new Notification('收到信息:-O', {
body: '這裡是通知內容!你想看什麼客官?',
icon: "../../images/headerPic/QQ圖片20160525234650.jpg"
});
} else {
var n = new Notification("baby! i will leave you!");
}
});
}
}
這裡有個關鍵設計:Notification.requestPermission 應該在使用者主動操作(例如點擊「開啟通知」按鈕)時呼叫,而不是頁面一載入就跳出詢問。前者是良好 manners,後者則會讓使用者反感並直接封鎖,反而永久失去機會。
第四步:Notification 構造函數的參數
Notification 構造函數的 title 屬性為必填,用於指定通知標題,格式為字串。options 屬性為選填,格式為一個物件,用於設定各項選項。該物件的屬性如下:
dir:文字方向,可能的值為 auto、ltr(從左到右)和 rtl(從右到左),一般繼承瀏覽器設定。
lang:使用的語種,比如 en-US、zh-CN。
body:通知內容,格式為字串,用於進一步說明通知的目的。
tag:通知的 ID,格式為字串。一組相同 tag 的通知不會同時顯示,只會在使用者關閉前一個通知後,於原位置顯示。
icon:圖示的 URL,用於顯示在通知上。
function otification_construct(){
var notification = new Notification('收到新郵件', {
body: '您有1封來自雪靜的未讀郵件。',
dir: "auto",
lang: "zh-CN",
tag: "a1",
icon: "../../images/headerPic/772513932673948130.jpg"
});
console.log(notification.title); // "收到新郵件"
console.log(notification.body); // "您有1封來自雪靜的未讀郵件。"
}
tag 這個屬性實務上很好用:當同一類通知連續發生(例如新訊息),設定相同 tag 就能避免通知層層堆疊,永遠只保留最新一則。
第五步:Notifications API 的相關事件
Notification 實例會觸發以下四種事件:
show:通知顯示給使用者時觸發。
click:使用者點擊通知時觸發。
close:使用者關閉通知時觸發。
error:通知出錯時觸發(通知無法正確顯示時出現)。
這些事件對應 onshow、onclick、onclose、onerror 方法,用於指定相應的回呼函數。addEventListener 也可用來為這些事件指定回呼函數。
function otification_event(){
var MM = new Notification("Hi! My beautiful little princess!", {
body: '您有1封來外太空的郵件。',
icon: "../../images/headerPic/20100114212301-1126264202.jpg"
});
MM.onshow = function() {
console.log('Notification showning!');
};
MM.onclick = function() {
console.log('Notification have be click!');
};
MM.onerror = function() {
console.log('Notification have be click!');
MM.close(); // 手動關閉
};
}
其中 onclick 在實務上最常被使用——通常會在這裡加上 window.focus() 把原視窗拉回前台,或 window.open() 導向相關頁面。少了這一步,使用者點了通知卻什麼都沒發生,體驗會很差。
完整 Demo 原始碼
<!DOCTYPE html>
<html>
<head lang="en">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta charset="utf-8">
<meta content="" name="description">
<meta content="" name="keywords">
<meta content="eric.wu" name="author">
<meta content="application/xhtml+xml;charset=UTF-8" http-equiv="Content-Type">
<meta property="qc:admins" />
<meta content="telephone=no, address=no" name="format-detection">
<meta content="width=device-width, initial-scale=1.0, minimum-scale=1.0,
maximum-scale=1.0, user-scalable=no" name="viewport">
<title>Web Notifications API</title>
</head>
<body>
查看右下角,的消息通知..........
</body>
</html>
<script type="text/javascript">
window.onload = function(){
justify_notifyAPI(); // 判斷瀏覽器是否支援 Web Notifications API
justify_showMess(); // 瀏覽器是否允許彈出實例
otification_construct(); // 實例展示彈出的內容
otification_event(); // Notifications API 的相關事件
}
// 判斷瀏覽器是否支援 Web Notifications API
function justify_notifyAPI(){
if (window.Notification) {
console.log("支援" + "Web Notifications API");
} else {
console.log("不支援" + "Web Notifications API");
}
}
// 瀏覽器是否允許彈出實例
function justify_showMess(){
if (window.Notification && Notification.permission !== "denied") {
Notification.requestPermission(function(status) {
if (status === "granted") {
var n = new Notification('收到信息:-O', {
body: '這裡是通知內容!你想看什麼客官?',
icon: "../../images/headerPic/QQ圖片20160525234650.jpg"
});
} else {
var n = new Notification("baby! i will leave you!");
}
});
}
}
// 實例展示彈出的內容
function otification_construct(){
var notification = new Notification('收到新郵件', {
body: '您有1封來自雪靜的未讀郵件。',
dir: "auto",
lang: "zh-CN",
tag: "a1",
icon: "../../images/headerPic/772513932673948130.jpg"
});
console.log(notification.title);
console.log(notification.body);
}
// Notifications API 的相關事件
function otification_event(){
var MM = new Notification("Hi! My beautiful little princess!", {
body: '您有1封來外太空的郵件。',
icon: "../../images/headerPic/20100114212301-1126264202.jpg"
});
MM.onshow = function() { console.log('Notification showning!'); };
MM.onclick = function() { console.log('Notification have be click!'); };
MM.onerror = function() {
console.log('Notification have be click!');
MM.close();
};
}
</script>
兩個實務上的重要限制
第一,必須在 HTTPS 環境下才能運作(localhost 例外)。以 http 提供的頁面,Notification API 會被瀏覽器直接停用,這是開發時最常踩的坑。
第二,行動裝置上的支援情況差異很大。在手機瀏覽器中,這個 API 長期支援不佳;若要在手機上收到通知,通常得走 PWA 搭配 Service Worker 與 Push API 的路線,或直接用各平台的推播服務。因此標題所說的「適用於手機和電腦」,在今日的實務中應該理解為:桌面瀏覽器可直接使用,行動裝置則需要額外的 PWA 建置。
最後提醒,Notification 一律需在 HTTPS 且取得使用者授權後才能建立。把請求權限的時機放在使用者明確表達意願的那一刻,是能否成功的一半關鍵。