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 decently lightweight at ~45 KB
- All user data points are available by design, not just the 32bit integer fingerprint
Documentation and Demos
You can find more documentation and demos on each method at clientjs.org.
To use ClientJS, simply include
npm install clientjs
bower install clientjs
Digital fingerprints are based on device/browser settings. They allow you to make an "educated guess" about the identify of a new or returning visitor. By taking multiple data points, combining them, and representing them as a number, you can be surprisingly accurate at recognizing not only browsers and devices, but also individual users.
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.
Simply create a new ClientJS object.
Then call the
getFingerprint() method which will return the browser/device fingerprint as a 32bit integer hash ID.
Below is an example of how to generate and display a fingerprint:
// Create a new ClientJS object var client = new ClientJS(); // Get the client's fingerprint id var 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
- system language
- canvas print
Below is the current list of available methods to find information on a users browser/device.
You can find documentation on each method at clientjs.org.
var 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(); client.isFlash(); client.getFlashVersion(); 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();
Shoulders of Giants
It is important to note this project owes much to other pieces great works. We had the advantage of observing how others had approached this problem.
All dependencies are included into
client.min.js when the
build.sh bash file minifies the project. Vendored dependencies should not be included separately.
Collaborate by forking this project and sending a Pull Request this way.
Once cloned, install all dependencies. ClientJS uses Karma as its testing environment.
# Install dependencies $ npm install # If you want tu run karma from the command line $ npm install -g karma-cli
Run Karma and enjoy coding!
$ karma start
Thanks for contributing to ClientJS! Please report any bug here.
This project is using the Apache LICENSE Version 2.0. It is included in the project source code.