User-Agent (UA) 字串解析曾是檢測瀏覽器的標準做法,但 UA 易偽造、格式混亂、維護成本高。現代最佳實踐是特性檢測優先,UA 解析為輔。本文提供完整的 UA 解析實作、正則細節、主流瀏覽器識別邏輯,並說明為何應避免依賴 UA 做業務邏輯分支。
function getBrowserInfo() {
const ua = navigator.userAgent.toLowerCase();
let browser = 'Unknown', version = 'Unknown';
// 解析順序很重要!Chrome UA 含 Safari,Edge 含 Chrome,需優先匹配
const patterns = [
// Edge (Chromium-based) - 必須在 Chrome 之前
{ name: 'Edge', regex: /edg\/([\d.]+)/ },
// Chrome - 必須在 Safari 之前
{ name: 'Chrome', regex: /chrome\/([\d.]+)/ },
// Firefox
{ name: 'Firefox', regex: /firefox\/([\d.]+)/ },
// Safari (需排除 Chrome/Edge)
{ name: 'Safari', regex: /version\/([\d.]+).*safari/ },
// IE 11
{ name: 'IE', regex: /trident\/.*rv:([\d.]+)/ },
// IE 10-
{ name: 'IE', regex: /msie ([\d.]+)/ },
// Opera (舊 Presto 核心)
{ name: 'Opera', regex: /opera\/([\d.]+)/ },
// 微信內嵌瀏覽器
{ name: 'WeChat', regex: /micromessenger\/([\d.]+)/ },
// QQ 內嵌
{ name: 'QQ', regex: /qq\/([\d.]+)/ },
];
for (const { name, regex } of patterns) {
const match = ua.match(regex);
if (match) {
browser = name;
version = match[1];
break;
}
}
// 作業系統檢測
let os = 'Unknown';
if (/windows nt 10/.test(ua)) os = 'Windows 10/11';
else if (/windows nt 6\.[123]/.test(ua)) os = 'Windows 7/8/8.1';
else if (/mac os x ([\d_]+)/.test(ua)) os = 'macOS ' + RegExp.$1.replace(/_/g, '.');
else if (/android ([\d.]+)/.test(ua)) os = 'Android ' + RegExp.$1;
else if (/iphone os ([\d_]+)/.test(ua)) os = 'iOS ' + RegExp.$1.replace(/_/g, '.');
else if (/linux/.test(ua)) os = 'Linux';
return { browser, version, os, ua };
}
// 使用
const info = getBrowserInfo();
console.log(`${info.browser} ${info.version} on ${info.os}`);
| 瀏覽器 | UA 關鍵字 | 備註 |
|---|---|---|
| Chrome | Chrome/<ver> | 含 Safari/<ver> |
| Edge (Chromium) | Edg/<ver> | 含 Chrome/<ver> |
| Firefox | Firefox/<ver> | 獨特標識 |
| Safari | Version/<ver> Safari/<ver> | 無 Chrome/Edge 關鍵字 |
| IE 11 | Trident/7.0; rv:11.0 | 無 MSIE 關鍵字 |
| 微信 | MicroMessenger/<ver> | 基於系統 WebView |
| Electron | Electron/<ver> Chrome/<ver> | 桌面應用 |
// ❌ 壞:依賴 UA 判斷是否支援 WebP
if (/chrome/i.test(ua)) useWebP();
// ✅ 好:直接檢測功能
function supportsWebP() {
const canvas = document.createElement('canvas');
canvas.width = 1; canvas.height = 1;
return canvas.toDataURL('image/webp').startsWith('data:image/webp');
}
// ✅ 好:CSS @supports
@supports (display: grid) { .layout { display: grid; } }
// ✅ 好:JS API 存在性檢測
if ('IntersectionObserver' in window) { /* ... */ }
if (navigator.clipboard) { /* ... */ }
標準化的高熵線索,需伺服器請求 (Sec-CH-UA 等 Header) 或 JS API:
// 高熵線索 (需權限/安全上下文)
navigator.userAgentData?.getHighEntropyValues(['platform', 'platformVersion', 'architecture', 'bitness', 'model'])
.then(ua => console.log(ua));
// 低熵線索 (同步可用)
console.log(navigator.userAgentData?.brands); // [{brand: 'Google Chrome', version: '120'}, ...]
console.log(navigator.userAgentData?.platform); // 'Windows'
console.log(navigator.userAgentData?.mobile); // false
ua-parser-js:輕量、準確、支援 Node/瀏覽器、持續更新bowser:專注瀏覽器識別platform.js:包含 OS、引擎、裝置類型import UAParser from 'ua-parser-js';
const parser = new UAParser();
const result = parser.getResult();
// { browser: {name: 'Chrome', version: '120.0.0'}, os: {name: 'Windows', version: '10'}, device: {type: undefined} }
特性檢測 > 行為檢測 > UA 解析。
只在統計、日誌、臨時修補舊 Bug 時使用 UA 解析,並引用成熟庫而非手寫正則。
拋棄 UA 分支邏輯,擁抱漸進增強與特性檢測,是前端工程師成熟的標誌。