➤ Browser user data
browser-user-data is a Javascript library that helps you collect common and not-so-common informations about your application user.
➤ Available data
Data | Available |
---|---|
Hardware information | ✔️ |
Platform information | ✔️ |
Referrer | ✔️ |
Geolocation | ✔️ |
Connected social media | ✔️ |
Geolocation without permission prompt | 🚧 |
Automatic geocoding | 🚧 |
➤ Installation
Use the package manager npm to install browser-user-data.
npm i browser-user-data --save
➤ Usage
If you are using browser-user-data with Typescript, you can import the package with the import sintax
import * as browserUserData from 'browser-user-data';
The usage will be like this:
browserUserData
.extractData()
.then(data => console.log(data))
The above method will for permission to collect the user Geolocation. If you don't need, just pass the extractLocation atribute of the configuration object has false:
browserUserData
.extractData({
extractLocation: false
})
.then(data => console.log(data))
This is the complete output:
{
"connectedSocialMedias": [
"Google",
"Facebook",
"Twitter"
],
"location": {
"latitude": -59.86851,
"longitude": -144.17642
},
"referrer": "https://www.npmjs.com/package/browser-user-data",
"platform": {
"name": "Chrome",
"version": "84.0.4147.125",
"layout": "Blink",
"os": {
"architecture": 64,
"family": "Windows",
"version": "10"
},
"description": "Chrome 84.0.4147.125 on Windows 10 64-bit",
"product": null,
"manufacturer": null
},
"hardware": {
"vendor": "Google Inc.",
"renderer": "ANGLE (Intel(R) HD Graphics 630 Direct3D11 vs_5_0 ps_5_0)",
"screenWidth": 2560,
"screenHeight": 1080,
"battery": {
"level": 1,
"charging": true
}
}
}
➤ Contributors
Caio Rolla |
caio.cesar.rolla@gmail.com |
You don't need state management if you use global variables. 🐛 |
➤ Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.