做一個仿微信的網頁版站點時,會遇到一個需求:新訊息進來時跳出桌面通知。這正是 HTML5 Notifications API 的用途。
<script>
var Notification = window.Notification || window.mozNotification || window.webkitNotification;
Notification.requestPermission(function (permission) {
// permission 會是 granted / denied / default
});
function show() {
var instance = new Notification("test title", {
body: "test message"
});
instance.onclick = function () { /* 點擊時要做的事 */ };
instance.onerror = function () { /* 發生錯誤時 */ };
instance.onshow = function () { /* 顯示時 */ };
instance.onclose = function () { /* 關閉時 */ };
return false;
}
</script>
核心只有兩件事:Notification.requestPermission 向使用者請求授權,以及 new Notification(標題, 選項) 實際發出通知。選項裡除了 body,還可以帶 icon 指定圖示。
window.addEventListener('load', function () {
// 尚未取得授權時先詢問
if (Notification && Notification.permission !== "granted") {
Notification.requestPermission(function (status) {
if (Notification.permission !== status) {
Notification.permission = status;
}
});
}
});
在 Firefox 上一切正常,Chrome 卻怎麼都不跳通知。翻查後找到說明:
Desktop Notifications can only be triggered via a user action. Typing into the JavaScript console has the same effect as raw JavaScript code embedded into the web page (no user action). Typing the JavaScript into the location bar, however, represents a user-action.
也就是說,Chrome 要求通知必須由使用者操作觸發。在 console 裡直接呼叫,效果等同於頁面中沒有使用者互動的 JS,因此會被忽略。
但我們顯然不可能在頁面上放一顆「請點我授權」的按鈕。實務上的解法很簡單:在使用者本來就會點擊的按鈕上順帶處理授權。Chrome 下是一次授權長期有效,除非使用者自己到設定裡關掉。
function showMsgNotification(title, msg) {
var Notification = window.Notification || window.mozNotification || window.webkitNotification;
if (Notification && Notification.permission === "granted") {
// 已授權,直接發出
var instance = new Notification(title, {
body: msg,
icon: "image_url"
});
instance.onclick = function () { /* 可導向訊息頁面 */ };
instance.onerror = function () { /* 錯誤處理 */ };
instance.onshow = function () {
setTimeout(instance.close, 3000); // 3 秒後自動關閉
};
instance.onclose = function () { /* 收尾 */ };
} else if (Notification && Notification.permission !== "denied") {
// 尚未決定,先請求授權
Notification.requestPermission(function (status) {
if (Notification.permission !== status) {
Notification.permission = status;
}
if (status === "granted") {
var instance = new Notification(title, {
body: msg,
icon: "image_url"
});
instance.onclick = function () { /* ... */ };
instance.onerror = function () { /* ... */ };
instance.onshow = function () {
setTimeout(instance.close, 3000);
};
instance.onclose = function () { /* ... */ };
} else {
return false;
}
});
} else {
return false; // 使用者已明確拒絕
}
}
三個分支分別對應「已授權」「尚未決定」「已拒絕」,這是最完整的處理方式。實務上還要注意兩點:通知需要在 HTTPS 環境下才能運作;此外 Safari 與 Chrome 的實作細節(例如 requestPermission 的呼叫方式)在不同版本間曾有差異,正式上線前務必實機測試。