@fingerprintjs/fingerprintjs-pro

What is @fingerprintjs/fingerprintjs-pro?

@fingerprintjs/fingerprintjs-pro is an advanced browser fingerprinting library that helps developers identify users across different sessions and devices. It provides robust and accurate identification by combining various browser and device attributes.

What are @fingerprintjs/fingerprintjs-pro's main functionalities?

Visitor Identification

This feature allows you to identify a visitor by generating a unique visitor ID based on their browser and device attributes.

const FingerprintJS = require('@fingerprintjs/fingerprintjs-pro');

(async () => {
  const fp = await FingerprintJS.load({ apiKey: 'your-api-key' });
  const result = await fp.get();
  console.log(result.visitorId);
})();

Bot Detection

This feature helps in detecting if the visitor is a bot by analyzing various signals from the browser and device.

const FingerprintJS = require('@fingerprintjs/fingerprintjs-pro');

(async () => {
  const fp = await FingerprintJS.load({ apiKey: 'your-api-key' });
  const result = await fp.get();
  console.log(result.bot);
})();

Incognito Mode Detection

This feature allows you to detect if the visitor is using incognito or private browsing mode.

const FingerprintJS = require('@fingerprintjs/fingerprintjs-pro');

(async () => {
  const fp = await FingerprintJS.load({ apiKey: 'your-api-key' });
  const result = await fp.get();
  console.log(result.incognito);
})();

Other packages similar to @fingerprintjs/fingerprintjs-pro

clientjs

ClientJS is a JavaScript library for browser fingerprinting and device detection. It provides basic functionalities for identifying users but lacks the advanced features and accuracy of @fingerprintjs/fingerprintjs-pro.

fingerprintjs2

FingerprintJS2 is an open-source browser fingerprinting library that generates a unique identifier for a browser. While it offers good basic fingerprinting capabilities, it does not provide the advanced features like bot detection and incognito mode detection available in @fingerprintjs/fingerprintjs-pro.

ua-parser-js

UA-Parser-JS is a JavaScript library to detect Browser, Engine, OS, CPU, and Device type/model from User-Agent data. It is more focused on parsing user-agent strings rather than comprehensive fingerprinting and lacks the advanced identification features of @fingerprintjs/fingerprintjs-pro.

README

Makes a website visitor identifier from a browser fingerprint. Unlike cookies and local storage, fingerprint stays the same in incognito/private mode and even when browser data is purged. Provides additional information and higher accuracy compared to Open Source FingerprintJS.

Quick start

Get a pro key:

1. Register a new PRO account at dashboard.fingerprint.com/signup (there is a free trial)
2. After registration go to the dashboard and select the created subscription
3. Go the "API Keys" page in the navigation side bar on the left side of the page
4. Copy a key with type "Public"

Install from NPM

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

import FingerprintJS from '@fingerprintjs/fingerprintjs-pro'

// Initialize an agent at application startup.
const fpPromise = FingerprintJS.load({ apiKey: 'your-pro-key' })

;(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

Alternatively you can install from CDN

<script>
  // Initialize the agent at application startup.
  const fpPromise = import('https://fpjscdn.net/v3/your-pro-key')
    .then(FingerprintJS => 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>

Note that you need to replace your-pro-key with a public API key from the dashboard.

Run this code

See also

🍿 Live demo

⏱ How to upgrade from Open Source to Pro in 30 seconds

⬆️ How to migrate from Fingerprint Pro version 2

📕 Fingerprint Pro documentation

▶️ Video: use Fingerprint Pro to prevent multiple signups