New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

API 文档 - `ua` 模块 #5

Open
cssmagic opened this Issue Jul 9, 2015 · 1 comment

Comments

Projects
None yet
1 participant
@cssmagic
Member

cssmagic commented Jul 9, 2015

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 cssmagic added the doc label Jul 9, 2015

@cssmagic

This comment has been minimized.

Member

cssmagic commented Jul 13, 2015

与 Underscore.ext 的差异:

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

新增以下接口:

  • .browser
  • .engine
  • .engineVersion
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment