框架會過時,Web Platform API 是永久資產。這 5 個 API 解決真實產品痛點,無需依賴第三方庫,體積極小、效能極佳、標準化程度高。
// 全螢幕工具模組
const Fullscreen = {
// 檢查支援度
isSupported: () => document.fullscreenEnabled ||
document.webkitFullscreenEnabled ||
document.mozFullScreenEnabled ||
document.msFullscreenEnabled,
// 進入全螢幕
async request(element = document.documentElement) {
if (!this.isSupported()) throw new Error('Fullscreen API not supported');
try {
if (element.requestFullscreen) return await element.requestFullscreen();
if (element.webkitRequestFullscreen) return await element.webkitRequestFullscreen();
if (element.mozRequestFullScreen) return await element.mozRequestFullScreen();
if (element.msRequestFullscreen) return await element.msRequestFullscreen();
throw new Error('No fullscreen method found');
} catch (err) {
if (err.name === 'TypeError') throw new Error('Element not in document or iframe without allowfullscreen');
throw err;
}
},
// 退出全螢幕
async exit() {
if (document.exitFullscreen) return await document.exitFullscreen();
if (document.webkitExitFullscreen) return await document.webkitExitFullscreen();
if (document.mozCancelFullScreen) return await document.mozCancelFullScreen();
if (document.msExitFullscreen) return await document.msExitFullscreen();
},
// 狀態監聽
onChange(handler) {
const events = ['fullscreenchange', 'webkitfullscreenchange', 'mozfullscreenchange', 'MSFullscreenChange'];
events.forEach(e => document.addEventListener(e, handler));
return () => events.forEach(e => document.removeEventListener(e, handler));
},
// 當前全螢幕元素
get element() {
return document.fullscreenElement ||
document.webkitFullscreenElement ||
document.mozFullScreenElement ||
document.msFullscreenElement;
},
// 是否處於全螢幕
get isFullscreen() { return !!this.element; }
};
// 使用範例
const video = document.getElementById('player');
document.getElementById('fsBtn').addEventListener('click', async () => {
try {
if (Fullscreen.isFullscreen) await Fullscreen.exit();
else await Fullscreen.request(video);
} catch (e) { console.error(e); }
});
Fullscreen.onChange(() => {
document.getElementById('fsBtn').textContent = Fullscreen.isFullscreen ? '⛶ 退出全螢幕' : '⛶ 進入全螢幕';
});
allow="fullscreen" 屬性webkitRequestFullscreen() 且不支援 document.exitFullscreen(),需用 webkitExitFullscreen()// 現代瀏覽器統一支援 document.hidden / visibilitychange
document.addEventListener('visibilitychange', () => {
if (document.hidden) {
console.log('📴 頁面隱藏:暫停資源消耗任務');
videoPlayer?.pause();
carousel?.stopAutoPlay();
ws?.close();
clearInterval(timerId);
saveDraft();
} else {
console.log('📺 頁面顯示:恢復任務');
videoPlayer?.play().catch(() => {}); // 自動播放策略可能阻擋
carousel?.startAutoPlay();
ws?.connect();
timerId = setInterval(pollUpdates, 30000);
syncData();
}
});
// 頁面卸載前同步(配合 beforeunload/pagehide)
window.addEventListener('pagehide', e => {
if (e.persisted) { // bfcache 情況
saveDraft(); // 輕量同步
}
});
document.visibilityState | 含義 |
|---|---|
visible | 頁面至少部分可見(非最小化、非背景分頁) |
hidden | 頁面完全不可見(最小化、背景分頁、鎖屏) |
prerender | 頁面正在預渲染(極少見) |
unloaded | 頁面正在卸載(舊規範) |
navigator.mediaDevices.getUserMedia(constraints)MediaStream,接給 <video> 或 AudioContextasync function initCamera(videoEl, { facingMode = 'user', width = 1280, height = 720 } = {}) {
try {
const stream = await navigator.mediaDevices.getUserMedia({
video: { facingMode, width: { ideal: width }, height: { ideal: height } },
audio: false
});
videoEl.srcObject = stream;
await videoEl.play();
return stream;
} catch (err) {
const messages = {
NotAllowedError: '用戶拒絕攝影機權限',
NotFoundError: '找不到攝影機裝置',
NotReadableError: '攝影機被其他應用佔用',
OverconstrainedError: '裝置不支援指定解析度',
SecurityError: '非安全上下文(需 HTTPS)'
};
throw new Error(messages[err.name] || err.message);
}
}
// 列舉裝置供用戶選擇
async function listVideoInputs() {
const devices = await navigator.mediaDevices.enumerateDevices();
return devices.filter(d => d.kind === 'videoinput').map(d => ({
deviceId: d.deviceId,
label: d.label || `攝影機 ${d.deviceId.slice(0,4)}`,
facing: /front|user/i.test(d.label) ? 'user' : 'environment'
}));
}
// 鏡像修正(前置鏡頭預覽鏡像,錄製/截圖不鏡像)
function applyMirrorFix(videoEl, isFrontCamera) {
videoEl.style.transform = isFrontCamera ? 'scaleX(-1)' : 'none';
}
// 檢測支援度
if ('getBattery' in navigator) {
navigator.getBattery().then(battery => {
// 靜態資訊
console.log('🔋 充電中:', battery.charging); // boolean
console.log('🔋 電量:', Math.round(battery.level * 100) + '%'); // 0.0-1.0
console.log('🔋 剩餘秒數:', battery.dischargingTime); // 秒,充電時為 Infinity
console.log('🔋 充滿秒數:', battery.chargingTime); // 秒,滿電時為 0
// 動態監聽
battery.addEventListener('chargingchange', () => {
console.log('充電狀態變更:', battery.charging ? '充電中' : '放電中');
if (!battery.charging && battery.level < 0.2) enablePowerSaveMode();
});
battery.addEventListener('levelchange', () => {
console.log('電量變更:', Math.round(battery.level * 100) + '%');
});
});
}
// 省電模式範例
function enablePowerSaveMode() {
document.documentElement.classList.add('power-save');
// CSS: .power-save * { animation: none !important; transition: none !important; }
// JS: 停止輪詢、降低影片品質、暫停非關鍵 WebWorker
}
| 類型 | 語法 | 用途 | 優先級 | 快取行為 |
|---|---|---|---|---|
| DNS Prefetch | <link rel="dns-prefetch" href="//cdn.example.com"> | 提前解析跨域 DNS | 低 | 無 |
| Preconnect | <link rel="preconnect" href="https://api.example.com"> | DNS + TCP + TLS 握手 | 高 | 無 |
| Prefetch | <link rel="prefetch" href="/next-page"> | 下一頁 HTML/資源(低優先級,閒時) | 低 | HTTP 快取 |
| Preload | <link rel="preload" as="script" href="critical.js"> | 當前頁關鍵資源(高優先級,立即) | 高 | Memory Cache → HTTP Cache |
| Prerender | <link rel="prerender" href="/checkout"> | 完整預渲染下一頁(極高資源消耗) | 最高 | 獨立渲染器進程 |
<head>
<!-- 關鍵第三方域名 -->
<link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>
<link rel="preconnect" href="https://api.payment.com" crossorigin>
<!-- 關鍵字體/腳本 -->
<link rel="preload" as="font" type="font/woff2" href="/fonts/NotoSansTC.woff2" crossorigin>
<link rel="preload" as="script" href="/js/app.critical.js">
<!-- 預測用戶下一步 -->
<link rel="prefetch" href="/dashboard">
<link rel="prefetch" href="/pricing">
</head>
黃金法則: Preload 當前頁必需資源(LCP 圖片、關鍵 CSS/JS)、Prefetch 高機率下一頁、Preconnect 必連第三方域、Prerender 僅用於極高確定性轉換(如結帳流程)。
這 5 個 API 覆蓋沉浸式體驗、生命週期感知、媒體裝置存取、硬體狀態感知、資源載入策略五大核心場景。它們不是「花俏功能」,而是構建專業級、體貼用戶、資源高效 Web 應用的基礎設施。建議建立團隊內部「Web API 速查卡」,新專案評估時檢視清單,該用原生 API 時堅決不引入第三方庫。