1.0.6-alpha5 • Published 3 years ago

sudongyu-info-js v1.0.6-alpha5

Weekly downloads
-
License
ISC
Repository
-
Last release
3 years ago

InfoJs ⚡

更方便的获取客户端信息

infoJs

Install 💡

npm install sudongyu-info-js --save

npm install sudongyu-infojs-plugin --save-dev

or

yarn add sudongyu-info-js

yarn add sudongyu-infojs-plugin --dev

Useage 🌲

step1: 配置vite插件

//在vite.config.js中进行配置
//引入我们安装的vite插件
import infoJsPlugin from 'sudongyu-infojs-plugin'
export default defineConfig({
  plugins: [vue(),infoJsPlugin()],
  //优化包依赖
  optimizeDeps:{
      //!!!在这里排除我们插件生成的虚拟路径
    exclude:['@infoJs-plugin-virtual-module']
  }
})

step2: 使用极其方便,并且在任意地方都可以使用

import 'sudongyu-info-js'//仅需在main.ts导入即可

tips:完成导入后,所有的信息对象都会被注入到window对象上

API 🍉

Window

window.browserInfo : BrowserInfo
window.browserExtension : BrowserExtension

BrowserExtension (Writable/Readable)

keyvalue解释
languagezh-cn客户端当前浏览器语言

BrowserInfo (OnlyRead)

keyvalue解释
screenResolution1080*1920客户端浏览器的分辨率
isMobileDevicefalse客户端是否为移动设备
userAgentMacIntel客户度浏览器
appPackageNamevue-demo-webapp包名
appVersion5.0 (Macintosh; Intel Mac OS X 10_15_7)...客户端浏览器的平台和版本信息
appVersionCode1.0.1app版本号
platformMacIntel客户端运行浏览器的操作系统平台
appIpAddress2409:8a62:810:93f0:1dd4:52b4:ab29:d752客户端ip地址
appIpCountryCN客户端ip所在地理位置
appModebeta|prodApp的运行环境
viteModedevelopment|buildApp的运行环境
clientClientInfo客户端信息对象

window.browserInfo.client

window.browserInfo.client : ClientInfo
key解释
packageName客户端包名
appVersionCode客户端版本号
appVersionName客户端版本名称
platform客户端平台
platformVersion客户端平台版本号
deviceId客户端设备Id
deviceBrand客户端设备品牌

example 📦

console.log(window.browserInfo.platform)//MacIntel
console.log(window.browserInfo.screenResolution)//1440*900
console.log(window.browserInfo.client)// a Object ^_^
console.log(window.browserInfo.isMobileDevice)// false
console.log(window.browserInfo.appIpAddress)//2409:8a62:810:93f0:1dd4:52b4:ab29:d752
console.log(window.browserInfo.appIpCountry)//CN
console.log(window.browserInfo.appMode)//beta
console.log(window.browserInfo.appPackageName)//vue-demo-web
console.log(window.browserInfo.appVersionCode)//1.0.0
......

console.log(window.browserExtension.language)//zh-cn
window.browserExtension.language='zh-cn'//set language

Future 🛠️

已完成:✅           未完成:❌

  • 应用版本号 ✅
  • 浏览器指纹 ❌
  • 用户ip地址 ✅
  • 用户所在国家 ✅
  • 项目运行的环境类型(prod beat )✅