先解釋一下標題裡的「啟用」:指的是這個分頁目前正在被使用者瀏覽,也就是當前分頁。
傳統網頁有個惱人的特性:使用者明明不在這個分頁上,它卻還在拼命工作。你正在看新聞,先前打開的賽事頁面仍持續輪詢比分;影片網站的背景分頁還在佔用頻寬下載資源。這些不必要的動作加起來,就是可觀的浪費。
常見的浪費場景包括:
Page Visibility API 的價值就在這裡,至少能帶來以下好處:
Page Visibility 會在 document 上加上兩個屬性:hidden 與 visibilityState。目前的分頁處於啟用狀態時,document.hidden 為 false,否則為 true。visibilityState 則有四種可能值:
此外 document 上還會觸發 visibilitychange 事件,當可見性改變時通知我們。
把下面的程式碼存成 HTML 檔,開啟後切換分頁即可看到效果:
<!doctype Html>
<Html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<title>測試 Html5 Page Visibility API</title>
</head>
<body>
<div id="showTip"></div>
<script>
function browerKernel(){
var result;
['webkit', 'moz', 'o', 'ms'].forEach(function(prefix){
if( typeof document[ prefix + 'Hidden' ] != 'undefined' ){
result = prefix;
}
});
return result;
}
function init(){
var prefix = browerKernel();
var showTip = document.getElementById('showTip');
document.addEventListener( prefix + 'visibilitychange', function onVisibilityChange(e){
var tip = null;
if( document[ prefix + 'VisibilityState' ] == 'hidden' ) tip = '<p>離開頁面</p>';
else if( document[ prefix + 'VisibilityState' ] == 'visible' ) tip = '<p>進入頁面</p>';
showTip.innerHTML = showTip.innerHTML + tip;
});
}
window.onload = init();
</script>
</body>
</Html>
這個範例做的事就是監聽分頁可見性的變化,並在變化時印出提示。
在 API 剛問世的年代,瀏覽器都是透過私有屬性支援它,因此偵測與使用時必須加上前綴。例如在 Chrome 上要讀 document.webkitVisibilityState,而不是 document.visibilityState;事件名也變成 webkitvisibilitychange。這也是範例要先跑一次 browerKernel() 探測的原因。
今天各大瀏覽器都已支援無前綴的標準寫法,前綴判斷可以保留作為防禦,但不必再是主要路徑。另外別忘了:分頁切到背景時,setInterval 與 requestAnimationFrame 本身就會被瀏覽器降頻,搭配 Page Visibility 做「明確暫停與恢復」才是乾淨的資源管理。