- 检测设备、操作系统、浏览器、屏幕、网络、语言和输入能力。
- 生成浏览器指纹和 UUID。
- 支持公历转农历。
- 支持浏览器、Node.js 和 SSR 环境安全调用。
- 提供 UMD、ESM 产物和 TypeScript 类型声明。
npm install @skillnull/device-js # or yarn add @skillnull/device-js # or pnpm add @skillnull/device-js
import Device, { type DeviceInfo, type DeviceInfoOptions } from '@skillnull/device-js' const options: DeviceInfoOptions = { info: ['deviceType', 'OS', 'browserInfo'] } const data: DeviceInfo = await Device.Info(options)
不传参数调用 Device.Info() 时，将返回全部可用信息。
UMD：
<script src="https://unpkg.com/@skillnull/[email protected]/dist/device.js"></script> <!-- or --> <script src="https://cdn.jsdelivr.net/npm/@skillnull/[email protected]/dist/device.js"></script>
ESM：
<script type="module"> import Device from 'https://unpkg.com/@skillnull/[email protected]/dist/device.es.js' const data = await Device.Info() </script>
| 配置 | 类型 | 说明 |
|---|---|---|
domain |
string |
生成浏览器指纹时使用的域名，默认为 window.location.host。 |
transferDateToLunar |
string |
请求 lunarDate 时需要转换的公历日期。 |
info |
DeviceInfoKey[] |
指定需要返回的字段，不传时返回全部字段。 |
locale |
'zh-CN' | 'en-US' |
文本结果使用的语言，默认为 zh-CN。 |
showLoading |
boolean |
是否显示加载层，默认显示；传入 false 时关闭。 |
可用的 info 字段：
| 分类 | 字段 |
|---|---|
| 设备 | deviceType, isEmulator, deviceModel, hardwareConcurrency |
| 系统 | OS, OSVersion, platform, language, timezone |
| 屏幕与输入 | screenHeight, screenWidth, viewportHeight, viewportWidth, devicePixelRatio, orientation, touchSupport, colorScheme |
| 浏览器与网络 | browserInfo, userAgent, netWork, cookieEnabled |
| 标识与位置 | fingerprint, UUID, geoPosition |
| 日期 | date, lunarDate, week |
部分信息依赖浏览器支持、User-Agent 数据或用户授权。其中地理位置需要用户明确授权。
# 完整发布：同步版本、验证、推送提交与 Tag，通过 GitHub CI 后发布 npm npm run publish # 只验证下一版本，不提交、不推送、不发布 npm run publish -- --dry-run
发布入口会同步 package.json、package-lock.json 和中英文 README 中的版本号。发布必须从与 origin/main 一致的干净 main 分支执行。
MIT © 2019-present skillnull