Skip to content

Latest commit

 

History

History
189 lines (136 loc) · 5.1 KB

README.md

File metadata and controls

189 lines (136 loc) · 5.1 KB

ClientJS Build Status

Device 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 43 KB
  • All user data points are available by design, not just the 32bit integer fingerprint

Docs/Demo

You can find more documentation on ClientJS at clientjs.jacks.io. Also there is an example/demo.

Installation

To use ClientJS, simply include the client.min.js file found in the dist directory, so dist/client.min.js when your in the project root directory.

Bower

ClientJS is also available as a bower package.

bower install clientjs

Fingerprinting

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/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
  • timezone
  • language
  • system language
  • cookies
  • canvas print

Available Methods

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.jacks.io.

  var client = new ClientJS();

  client.getBrowserData();
  client.getFingerPrint();

  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 that this project owes much to many other pieces of work. I had the advantage of searching through how many others have approached this problem before me.

Built Upon:

  • https:github.com/Valve/fingerprintjs
  • http:darkwavetech.com/device_fingerprint.html
  • detectmobilebrowsers.com

Vendor Code

All dependencies are automatically included into client.min.js when the build.sh file compiles this project. They do not need to be included separately.

Dependencies Include:

  • ua-parser.js
  • fontdetect.js
  • swfobject.js
  • murmurhash3.js

LICENSE

This project is using the GNU GENERAL PUBLIC LICENSE. It is included in the project source code.