Device information and digital fingerprinting written in pure JavaScript.
npm install clientjsDevice information and digital fingerprinting written in _pure_ JavaScript.
  

ClientJS is a JavaScript library that makes digital fingerprinting easy, while also exposing all the browser data-points used in generating fingerprints.
If you want to fingerprint browsers, you are _probably_ also interested in other client-based information, such as screen resolution, operating system, browser type, device type, and much more.
Below are some features that make ClientJS different from other fingerprinting libraries:
- It's pure native JavaScript
- It's decently lightweight at ~55 KB (full bundle) or ~28 KB (minimal bundle)
- All user data points are available by design, not just the 32bit integer fingerprint
dist/client.base.min.js or one of the other bundles (see bundles section for more details)``shell`
npm install clientjs
This is useful for identifying users or devices without cookies or sessions.
It is not a full proof technique, but it has been shown to be statistically significant at accurately identifying devices.
First, you'll need to import the library. You can do it in different ways, depending on your environment:
`js
// in an ES6 environment:
import { ClientJS } from 'clientjs';
// via CommonJS imports:
const { ClientJS } = require('clientjs');
// in a browser, when using a script tag:
const ClientJS = window.ClientJS;
`
After having imported the library, simply create a new ClientJS object and call the getFingerprint() method which will return
the browser/device fingerprint as a 32bit integer hash ID.
`js
// Create a new ClientJS object
const client = new ClientJS();
// Get the client's fingerprint id
const fingerprint = client.getFingerprint();
// Print the 32bit hash id to the console
console.log(fingerprint);
`
The current data-points that used to generate fingerprint 32bit integer hash ID is listed below:
- user agent
- screen print
- color depth
- current resolution
- available resolution
- device XDPI
- device YDPI
- plugin list
- font list
- local storage
- session storage
- timezone
- language
- system language
- cookies
- canvas print
- dist/client.min.js - full distribution bundle, contains Flash and Java detection mechanismsdist/client.flash.min.js
- - contains Flash detection mechanism but misses Java detection (getJavaVersion() will throw an error when called)dist/client.java.min.js
- - contains Java detection mechanism but misses Flash detection (getFlashVersion() will throw an error when called)dist/client.base.min.js
- - misses both, Flash and Java detection mechanisms (getFlashVersion() and getJavaVersion() will throw an error when called)
You can find documentation on each method at clientjs.org.
`js
const client = new ClientJS();
client.getBrowserData();
client.getFingerprint();
client.getCustomFingerprint(...);
client.getUserAgent();
client.getUserAgentLowerCase();
client.getBrowser();
client.getBrowserVersion();
client.getBrowserMajorVersion();
client.isIE();
client.isChrome();
client.isFirefox();
client.isSafari();
client.isOpera();
client.getEngine();
client.getEngineVersion();
client.getOS();
client.getOSVersion();
client.isWindows();
client.isMac();
client.isLinux();
client.isUbuntu();
client.isSolaris();
client.getDevice();
client.getDeviceType();
client.getDeviceVendor();
client.getCPU();
client.isMobile();
client.isMobileMajor();
client.isMobileAndroid();
client.isMobileOpera();
client.isMobileWindows();
client.isMobileBlackBerry();
client.isMobileIOS();
client.isIphone();
client.isIpad();
client.isIpod();
client.getScreenPrint();
client.getColorDepth();
client.getCurrentResolution();
client.getAvailableResolution();
client.getDeviceXDPI();
client.getDeviceYDPI();
client.getPlugins();
client.isJava();
client.getJavaVersion(); // functional only in java and full builds, throws an error otherwise
client.isFlash();
client.getFlashVersion(); // functional only in flash and full builds, throws an error otherwise
client.isSilverlight();
client.getSilverlightVersion();
client.getMimeTypes();
client.isMimeTypes();
client.isFont();
client.getFonts();
client.isLocalStorage();
client.isSessionStorage();
client.isCookie();
client.getTimeZone();
client.getLanguage();
client.getSystemLanguage();
client.isCanvas();
client.getCanvasPrint();
`
Built Upon:
- https://web.archive.org/web/20200714191004/https://github.com/Valve/fingerprintjs
- https://web.archive.org/web/20200411083356/https://www.darkwavetech.com/index.php/device-fingerprint-blog
- http://detectmobilebrowsers.com
Once cloned, install all dependencies. ClientJS uses Karma as its testing environment.
`shell`Install dependencies
$ npm install
Run Karma and enjoy coding!
`shell`
$ npm test
Thanks for contributing to ClientJS! Please report any bug here.
To make a new release, use the release-it tool, this will guide you through the release process:
`sh`
npx release-it
You can make a dry run of the release process with the following command:
`sh``
npx release-it --dry-run