fingerprintjs: A TypeScript repository from nikitok

FingerprintJS is a browser fingerprinting library that queries browser attributes and computes a hashed visitor identifier from them. Unlike cookies and local storage, a fingerprint stays the same in incognito/private mode and even when browser data is purged.

View Our Demo.

Quick start

Install from CDN

<script>
  function initFingerprintJS() {
    // Initialize an agent at application startup.
    const fpPromise = FingerprintJS.load()

    // Get the visitor identifier when you need it.
    fpPromise
      .then(fp => fp.get())
      .then(result => {
        // This is the visitor identifier:
        const visitorId = result.visitorId
        console.log(visitorId)
      })
  }
</script>
<script
  async
  src="//cdn.jsdelivr.net/npm/@fingerprintjs/fingerprintjs@3/dist/fp.min.js"
  onload="initFingerprintJS()"
></script>

Run this code

Alternatively you can install from NPM to use with Webpack/Rollup/Browserify

npm i @fingerprintjs/fingerprintjs
# or
yarn add @fingerprintjs/fingerprintjs

import FingerprintJS from '@fingerprintjs/fingerprintjs'

// Initialize an agent at application startup.
const fpPromise = FingerprintJS.load()

;(async () => {
  // Get the visitor identifier when you need it.
  const fp = await fpPromise
  const result = await fp.get()

  // This is the visitor identifier:
  const visitorId = result.visitorId
  console.log(visitorId)
})()

Run this code

📕 Full documentation

Switch to Pro version for free to get 99.5% identification accuracy

FingerprintJS Pro is a professional visitor identification service that processes all information server-side and transmits it securely to your servers using server-to-server APIs. Pro combines browser fingerprinting with vast amounts of auxiliary data (IP addresses, time of visit patterns, URL changes and more) to be able to reliably deduplicate different users that have identical devices, resulting in 99.5% identification accuracy.

You can use Pro FREE for up to 1,000 unique monthly visitors - no credit card required.

Full product comparison:

	Open Source	Pro
Core Features
100% Open-source	yes	no*
Standard fingerprint signals screen, os, device name	✓	✓
Advanced fingerprint signals canvas, audio, fonts	✓	✓
ID type	fingerprint	visitorID**
ID lifetime	several weeks	months/years
ID origin	client	server
ID collisions	common	rare
Additional Features
Incognito mode detection works in all modern browsers - see our full list of browsers supported	–	✓
Server-side accuracy increase based on additional server-side signals, such as TLS crypto support, ipv4/v6 data and others	–	✓
Query API & realtime Webhooks build flexible workflows	–	✓
Geolocation based on IP address	–	✓
Operations
Data security	Your infrastructure	Encrypted at rest
Storage	Your infrastructure	Unlimited up to 1 yr
Regions	Your infrastructure	Hosting in US and EU
Compliance	Your infrastructure	GDPR, CCPA compliant***
SLA	No SLA	99.9% Uptime
Support	GitHub community	Support team via email, chat, and call-back within 1 business day

* Pro uses the open source fingerprinting library as well as proprietary technology for increased accuracy and stability.

** VisitorIDs, in comparison to fingerprints, include server side techniques, are deduplicated and utilize fuzzy matching to result in a more accurate and stable identifier. Fingerprint hashes rely on an exact match across all browser attributes, making them unstable across > 2 week time intervals.

*** FingerprintJS is GDPR and CCPA compliant as the data processor. You still need to be compliant as the data controller and use the identification for fraud under legitimate interest or ask for user consent.

Pro result example:

{
  "requestId": "HFMlljrzKEiZmhUNDx7Z",
  "visitorId": "kHqPGWS1Mj18sZFsP8Wl",
  "visitorFound": true,
  "incognito": false,
  "browserName": "Chrome",
  "browserVersion": "85.0.4183",
  "os": "Mac OS X",
  "osVersion": "10.15.6",
  "device": "Other",
  "ip": "192.65.67.131",
  "ipLocation": {
    "accuracyRadius": 100,
    "latitude": 37.409657,
    "longitude": -121.965467
    // ...
  }
}