epackage-device-detect

环境检测工具 V2

检测用户当前使用的设备、系统等硬件环境。

V2.0.1发行

！！！V2.0.0版本因代码兼容问题，导致出现异常问题，请及时更新V2.0.1版本。

V2.0.1版本现已发行，该版本基于ua-parser-js进行重构，兼容性得到显著提高，并支持使用更多配置选项。

• ✅ 新增：使用getEngineView检测渲染器名称及版本。
• ✅ 新增：品牌检测方法BrandFunc，支持热门品牌类型检测。
• 🚀 重构：getBrowserView、getDeviceView自定义方法变更，现已支持更多类型浏览器检测。
• 🚀 重构：检测方法采用全新逻辑处理，结合uaparser.js实现。
• 🔙 移除：getBrowserView的isBrowser属性已移除。
• 🔙 移除：isBrowser（）方法已移除。
• 🩹 修复：V2.0.0版本因未对关键方法做兼容处理导致异常报错。

建议您使用最新V2.0.1版本。

说明

部分方法、函数可能使用废弃的JS API实现，或使用了实验性功能，该标准取决于MDN文档，如使用包含下列特殊备注的方法、函数，epackage-device-detect默认您已接受未知的风险。

特殊标识列表：

🧪：实验性，该方法采用了实验性API实现，未来版本可能会被删除。

🚮：废弃的，该方法使用了已废弃的JS API实现，epackage-device-detect将会在未来版本中找到最优解决方案。

❌：不可使用，该标识下的方法暂未实现，但在未来版本中可能会实现，未实现方法返回值默认为true。

安装

• npm

npm install epackage-device-detect

• yarn：

yarn add epackage-device-detect

如何使用

您可以使用以下方法导入：

import device from 'epackage-device-detect';

function getDevice() {
  const browserData = device.getBrowserView();
  const systemData = device.getSystemView();

  console.log(browserData, systemData);
}

如果您不需要全部引入，您可以选择使用部分API：

import { getBrowserView, getSystemView } from 'epackage-device-detect';

// ...同上

函数

方法

浏览器检测

设备检测

系统检测

品牌检测

以下列表中展示的为 epackage-device-detect 自定义属性，其余原生属性不在此处展示，您可在MDN Navigator文档中查看。

getBrowserView返回值

browser属性：

name：浏览器名称，例如：

2345Explorer, 360 Browser, Amaya, Android Browser, Arora, Avant, Avast, AVG, BIDUBrowser, Baidu, Basilisk, Blazer, Bolt, Brave, Bowser, Camino, Chimera, [Mobile] Chrome [Headless/WebView], Chromium, Cobalt, Comodo Dragon, Dillo ...

version：浏览器版本号，例如：

5.1.21214

major：浏览器主版本号，例如：

5

查看详细文档，点击查看getBrowser()

getSystemView返回值

system属性：

name：系统名称，例如：

AIX, Amiga OS, Android[-x86], Arch, Bada, BeOS, BlackBerry, CentOS, Chromium OS,Contiki, Fedora, Firefox OS, FreeBSD, Debian, Deepin, DragonFly, elementary OS, Fuchsia, Gentoo, GhostBSD, GNU, Haiku, HarmonyOS, HP-UX, Hurd, iOS, Joli, KaiOS, Linpus, Linspire, Linux ...

version：系统版本：例如：

12

查看详细文档，点击查看getEngine()

getConnectionView返回值

downlink属性：

speed：当前网络速度，例如：

6.4M/s

value：当前网络速度值，例如：

6.4

unit：当前网络速度单位，例如：

M/s

getDeviceView返回值

device属性：

model：设备型号，例如：

SM-X706B

type：设备类型，例如：

mobile, tablet, smarttv, console, wearable, embedded

vendor：设备商家，例如：

Acer, Alcatel, Amazon, Apple, Archos, ASUS, AT&T, BenQ, BlackBerry, Dell, Essential, Facebook, Fairphone, GeeksPhone, Google, HP, HTC, Huawei, Jolla, Kobo, Lenovo, LG, Meizu,Microsoft, Motorola, Nexian, Nintendo, Nokia, Nvidia, OnePlus,  OPPO, Ouya, Palm ...

查看详细文档，点击查看getDevice()

getEngineView返回值

engine属性：

name：渲染器名称，例如：

Amaya, Blink, EdgeHTML, Flow, Gecko, Goanna, iCab, KHTML, LibWeb, Links, Lynx, NetFront, NetSurf, Presto, Tasman, Trident, w3m, WebKit

version：渲染器版本：例如：

2.5.25

查看详细文档，点击查看getEngine()

许可证

MIT