談到 HTML5,多數人第一時間想到的是 <video>、<canvas> 這類新標籤。但真正改變網頁開發面貌的,其實是那些掛在 window、document 與 navigator 上的瀏覽器 API——它們讓網頁能做到過去只有桌面程式或原生 App 才辦得到的事。
以下五個 API 都很實用,分別處理全螢幕、頁面可見狀態、影音串流、電量資訊與資源預載,值得收進你的工具箱。
以前想看滿版內容只能按 F11,現在用幾行程式碼就能把整個頁面、甚至某個單一元素推進全螢幕模式。影片播放頁、簡報工具、圖表儀表板與瀏覽器遊戲,都能因此獲得接近原生程式的沉浸體驗。
實作時要注意各家瀏覽器的方法名前綴差異,最保險的做法是先做一次能力偵測:
// 找出當前瀏覽器支援的全螢幕方法
function launchFullScreen(element) {
if (element.requestFullScreen) {
element.requestFullScreen();
} else if (element.mozRequestFullScreen) {
element.mozRequestFullScreen();
} else if (element.webkitRequestFullScreen) {
element.webkitRequestFullScreen();
}
}
// 啟動全螢幕
launchFullScreen(document.documentElement); // 整個頁面
launchFullScreen(document.getElementById('videoElement')); // 單一元素
傳入 document.documentElement 會讓整頁進入全螢幕,傳入特定元素則只放大該區塊。要退出時呼叫 document.exitFullscreen()(同樣有 webkit、moz 前綴版本),並記得監聽 fullscreenchange 事件,才能同步調整版面與圖示狀態。
這個 API 用來回報目前頁面的可見狀態。當使用者切到別的分頁、最小化視窗或鎖定螢幕時,頁面就會進入隱藏狀態並觸發事件。
有了它,你就能在背景分頁暫停 video 播放、動畫迴圈與輪詢請求,等使用者切回來再恢復,既省電又省流量。實作上同樣需要處理前綴:
// 各瀏覽器的屬性與事件名稱可能帶有前綴
var hidden, state, visibilityChange;
if (typeof document.hidden !== 'undefined') {
hidden = 'hidden';
visibilityChange = 'visibilitychange';
state = 'visibilityState';
} else if (typeof document.mozHidden !== 'undefined') {
hidden = 'mozHidden';
visibilityChange = 'mozvisibilitychange';
state = 'mozVisibilityState';
} else if (typeof document.msHidden !== 'undefined') {
hidden = 'msHidden';
visibilityChange = 'msvisibilitychange';
state = 'msVisibilityState';
} else if (typeof document.webkitHidden !== 'undefined') {
hidden = 'webkitHidden';
visibilityChange = 'webkitvisibilitychange';
state = 'webkitVisibilityState';
}
// 監聽可見性變化,在回呼裡決定要啟動還是停止處理
document.addEventListener(visibilityChange, function () {
if (document[hidden]) {
// 頁面被藏起來:暫停計時器、動畫或請求
} else {
// 使用者回來了:恢復先前的工作
}
}, false);
過去想在網頁上取景,得靠 Flash 或第三方外掛。getUserMedia 讓網頁在取得使用者授權後,直接拿到攝影機與麥克風的串流,視訊通話、線上客服、AR 濾鏡、拍照上傳等應用因此都能純前端完成。
window.addEventListener('DOMContentLoaded', function () {
var canvas = document.getElementById('canvas'),
context = canvas.getContext('2d'),
video = document.getElementById('video'),
videoObj = { 'video': true },
errBack = function (error) {
console.log('Video capture error: ', error.code);
};
if (navigator.getUserMedia) { // 標準寫法
navigator.getUserMedia(videoObj, function (stream) {
video.src = stream;
video.play();
}, errBack);
} else if (navigator.webkitGetUserMedia) { // WebKit 前綴
navigator.webkitGetUserMedia(videoObj, function (stream) {
video.src = window.webkitURL.createObjectURL(stream);
video.play();
}, errBack);
}
}, false);
補充一點:現代瀏覽器已把這組 API 統一為 navigator.mediaDevices.getUserMedia(),回傳 Promise,而且只允許在 HTTPS 或 localhost 環境下使用。上面的寫法適合作為理解原理的入門,實際專案建議採用新介面,並記得在 UI 上清楚告知使用者鏡頭正在被使用。
這個 API 主要面向行動裝置,讓網頁能讀取電量比例、是否正在充電、剩餘可用時間等資訊。你可以據此調整策略,例如電量過低時自動關閉高耗能動畫、降低輪詢頻率,或提示使用者接上電源。
var battery = navigator.battery || navigator.webkitBattery || navigator.mozBattery;
// 讀取電池屬性
console.warn('Battery charging: ', battery.charging); // true
console.warn('Battery level: ', battery.level); // 0.58
console.warn('Battery discharging time: ', battery.dischargingTime);
// 監聽狀態變化
battery.addEventListener('chargingchange', function () {
console.warn('Battery charge change: ', battery.charging);
}, false);
要提醒的是,基於隱私考量,多數現代瀏覽器已移除或大幅限制這個 API(改為 navigator.getBattery() 且只回傳粗略值)。因此電量資訊只適合當作「加分優化」,絕不能作為功能能否運作的判斷依據。
預先載入(prefetch)讓瀏覽器在使用者真正點擊之前,就把後續可能需要的頁面或資源抓進快取。對於流程固定的網站,例如結帳步驟、多頁表單、圖片相簿,這能大幅降低等待感,讓操作看起來一氣呵成。
<!-- 預先載入整個頁面 -->
<link rel="prefetch" href="https://example.com/next-step" />
<!-- 也可以只預先載入一張圖片 -->
<link rel="prefetch" href="https://example.com/banner.jpg" />
使用上有兩個原則:一是要挑「使用者下一步很可能會去」的資源,亂抓只會浪費頻寬;二是搭配 prefetch 的兄弟規格一起思考,例如 dns-prefetch 提前解析網域、preconnect 提前建立連線、preload 提前載入當前頁面一定要用到的關鍵資源,三者用途不同,別混用。
這五個 API 的共同特色是:都能用很少的程式碼,換到明顯的使用體驗提升。不過瀏覽器 API 的支援度一直在變動,正式上線前建議都做一次能力偵測,並準備好降級方案,讓不支援的環境也能正常運作。