API 文档 - ua 模块

[cssmagic]

API 文档 - ua 模块

这个模块在加载时会对当前 UA 进行探测（通过特性检测或 UA 字符串分析等方式），并以变量的方式提供探测结果。

这些探测浏览器内核和类型的接口仅用于底层开发或流量统计，不建议在业务层的常规功能中使用。

JavaScript 变量  

.isTouchDevice  

布尔值。当前 UA 是否为触屏设备。Chrome 开启触摸调试之后也将被视为触屏设备。

此探测基于特性检测。

---

.isSafari  

布尔值。当前 UA 是否为 Safari 浏览器（包括桌面版与移动版）。

此探测基于 UA 信息。

.isChrome  

布尔值。当前 UA 是否为 Chrome 浏览器（包括桌面版与移动版）。

此探测基于 UA 信息。

---

.isIOS  

布尔值。当前操作系统是否为 iOS 系统。

还有以下对 iOS 设备更细节的探测（值为布尔值或 undefined）：

• .isIPhone -- 当前 UA 是否为 iPhone。
• .isIPad -- 当前 UA 是否为 iPad。
• .isIPod -- 当前 UA 是否为 iPod touch。

这些探测均基于 UA 信息。

.isAndroid  

布尔值。当前 UA 是否为 Android 系统。

此探测基于 UA 信息。

.isMobileDevice  

布尔值。当前 UA 是否为移动设备。所有 iOS 和 Android 设备会被识别为移动设备。

此探测基于 UA 信息。

---

.osVersion  

字符串。当前移动操作系统的版本号，格式为 {主版本号}.{次版本号}。仅可识别 iOS 和 Android 系统的版本号，对于非移动操作系统或不可识别的移动操作系统，其值一律为空字符串。

此探测基于 UA 信息。

示例

• '7.0' -- 对 iOS 7.0.1 的探测结果。
• '4.4' -- 对 Android 4.4.4 的探测结果。
• '' -- 对 Windows、Mac OS、WinPhone 等系统的探测结果。

---

.browser  

字符串。当前浏览器的名称，可能的值如下：

• 'chrome' -- Chrome（谷歌浏览器）
• 'safari' -- Safari（苹果浏览器）
• 'firefox' -- Firefox（火狐浏览器）
• 'opera' -- Opera 浏览器
• 'uc' -- UC 浏览器
• 'baidu-app' -- 百度客户端
• 'baidu-browser' -- 百度浏览器
• 'm-qq-browser' -- 手机 QQ 浏览器
• 'miui' -- 小米浏览器
• 'ie-mobile' -- IE 移动版
• 'edge' -- 微软 Edge 浏览器
• 'wechat' -- 微信
• 'weibo' -- 微博
• 'chrome-webview' -- 采用 Chrome 内核的 WebView

此探测基于 UA 信息。

.engine  

字符串。当前浏览器的引擎（内核）名称，可能的值如下：

• 'webkit' -- iOS 与新版 Android 浏览器的内核
• 'chrome' -- Chrome 内核（新版 Android 浏览器与 Opera 的内核）
• 'gecko' -- Firefox 的内核
• 'presto' -- 旧版 Opera 的内核
• 'edge' -- Edge 内核

对于无法识别的引擎，其值一律为空字符串。

此探测基于 UA 信息。

.engineVersion  

字符串。当前浏览器的引擎（内核）版本。对于无法识别的引擎版本，其值一律为空字符串。

此探测基于 UA 信息。

示例

• '533.1' -- 对 Android 2.2.2 内置浏览器引擎 WebKit 版本的探测结果。
• '43.0' -- 对 Chrome 43.0.2357.65 引擎版本的探测结果。
• '' -- 对 Firefox 引擎版本的探测结果。
• '' -- 对 Edge 引擎版本的探测结果。

[cssmagic]

与 Underscore.ext 的差异：

• 已移除 .isWebKit
• 已移除 .isMoz

新增以下接口：

• .browser
• .engine
• .engineVersion