Browser fingerprinting library
Repo MADEVAL/Fingerprint-JS, read from GitHub 1 min ago. MADEVAL has not joined Take My Repo.
MADEVAL/Fingerprint-JS is a public repo on GitHub by MADEVAL. Browser fingerprinting library. It declares the MIT license on GitHub. It is written mainly in JavaScript, has 43 stars and last changed on 2026-06-30. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
FingerprintJS by BotBlocker is a browser fingerprinting and device intelligence SDK for risk, fraud, and bot-defense workflows. It is designed to pair with BotBlocker Security while remaining usable as a standalone ESM package or a direct script-tag bundle.
This library powers device identification in the BotBlocker Security plugin for WordPress — a comprehensive protection suite for WordPress sites.
The runtime has no production dependencies, performs no network calls by default, and exposes privacy-aware collector policies, deterministic identity hashing, report-only risk signals, bot evidence, private-mode indicators, confidence scoring, storage state, and compact diagnostics.
npm install @globus.studio/fingerprintjs
visitorId.@globus.studio/fingerprintjs/server: replay protection, client hash recomputation, server-only hashing, explainable backend reports, and pluggable network risk checks.Requires Node.js >= 18.
git clone https://github.com/MADEVAL/Fingerprint-JS.git
cd Fingerprint-JS
npm ci
npx playwright install --with-deps chromium firefox webkit
npm run verifyGenerated browser builds:
dist/browser/fingerprintjs.jsdist/browser/fingerprintjs.min.jsPackage entry points:
@globus.studio/fingerprintjs — main client API@globus.studio/fingerprintjs/collectors — collector creators and defaults@globus.studio/fingerprintjs/policy — permission and privacy policy engine@globus.studio/fingerprintjs/server — backend verification and replay protection@globus.studio/fingerprintjs/storage — in-memory and localStorage adapters@globus.studio/fingerprintjs/browser / ./browser.min — IIFE bundles for script-tag usageEach package entry supports ESM import and CommonJS require. Browser builds expose the FingerprintJSBotBlocker global. TypeScript declarations are included for all entry points.
import { createAnalysisReport, hashComponents, loadClient } from '@globus.studio/fingerprintjs'; const client = await loadClient({ namespace: 'my-product', useCase: 'fraud-defense', storage: 'local', identity: { denyCollectors: ['browser.botDetection', 'browser.privacyMode'], includeNonHashable: false } }); const result = await client.get({ consent: { granted: true, purpose: 'fraud-prevention' } }); const bot = result.components.find((component) => component.id === 'browser.botDetection'); const privacy = result.components.find((component) => component.id === 'browser.privacyMode'); const recalculated = await hashComponents(result.components, { namespace: 'my-product' }); const analysis = createAnalysisReport(result, { recalculatedHash: recalculated }); console.log({ visitorId: result.visitorId, bot: bot?.value?.verdict, privateMode: privacy?.value?.verdict, confidence: result.confidence, hashMatches: recalculated.visitorId === result.visitorId, analysis });
const { createClient } = require('@globus.studio/fingerprintjs'); const client = createClient({ namespace: 'node-service', collectors: [], storage: false });
The server package adds replay protection, server-only hashing, result verification, and network risk adapters. It is intended for backend use and is not included in the browser global bundle.
import { createMemoryReplayStore, createReplayToken, verifyFingerprintResult } from '@globus.studio/fingerprintjs/server'; const replayStore = createMemoryReplayStore(); const replayToken = await createReplayToken({ secret: process.env.FINGERPRINT_SERVER_SECRET, purpose: 'login-risk' }); const verification = await verifyFingerprintResult(resultFromBrowser, { secret: process.env.FINGERPRINT_SERVER_SECRET, replayToken, replayStore, network: { ip: request.ip }, networkAdapter: yourIpRiskAdapter }); if (!verification.ok || verification.network?.verdict === 'high_risk_network') { // Increase friction, deny the request, or send the event to BotBlocker Security. }
Copy the browser bundle from dist/browser/fingerprintjs.min.js to your public directory, or load directly from a CDN:
<!-- unpkg --> <script src="https://unpkg.com/@globus.studio/fingerprintjs/dist/browser/fingerprintjs.min.js"></script> <!-- jsdelivr --> <script src="https://cdn.jsdelivr.net/npm/@globus.studio/fingerprintjs/dist/browser/fingerprintjs.min.js"></script>
<script> const client = FingerprintJSBotBlocker.createClient({ namespace: location.hostname || 'botblocker-demo', profile: 'extended', storage: 'local' }); client.prepare({ consent: { granted: true } }); async function identify() { const result = await client.get({ consent: { granted: true, purpose: 'security' } }); console.log(result.visitorId, result.confidence, result.components); } </script>
The SDK returns a deterministic visitorId, a full component list, confidence metrics, hash metadata, timing data, storage state, and per-component status/error details.
Identity and report-only data are deliberately separated:
component.hashable === true: eligible for the stable visitorId hash when policy and identity options allow it.component.hashable === false: collected for risk, diagnostics, and reports, but excluded from visitorId by default.result.meta.identityComponents: exact component IDs used for the current visitorId.result.meta.reportOnlyComponents: ok components collected for reporting but not used for the current visitorId.The default collector pack keeps volatile and risk-oriented sources such as bot evidence, private-mode indicators, network connection, performance memory, storage capabilities, payment availability, private click measurement, and DOM blocker checks out of the identity hash. This keeps repeated identifications stable while still returning the signals needed for enforcement decisions.
hashComponents() follows the same identity-safe default. Pass includeNonHashable: true only when intentionally comparing an all-signals diagnostic hash.
Core signal groups:
Bot detection is evidence-based. Strong signals such as WebDriver exposure, known automation globals, headless user agents, and impossible browser dimensions increase the score. Weaker inconsistencies such as language mismatches, impossible hardware ranges, plugin structure anomalies, patched permissions APIs, and empty Chromium globals are reported as evidence without being treated as proof by themselves.
Tamper evidence is also evidence-based. browser.tamperEvidence reports patched native APIs, platform/client-hints mismatches, zero screen dimensions, suspicious language lists, and patched canvas serialization. It is report-only by default and should be combined with server verification before enforcement.
Private-mode detection is intentionally conservative. Modern browsers do not expose a universal incognito flag, so browser.privacyMode reports likelihood, score, confidence, and evidence from storage availability, IndexedDB behavior, quota estimates, and persistence state.
strict: low-sensitivity passive signals only.balanced: low- and medium-sensitivity passive signals for default product analytics.extended: active and high-sensitivity collectors for explicit security and fraud-prevention use cases.Policy controls include consent gates, sensitivity limits, active collector permission, allow/deny lists, category filters, and optional value redaction.
Use-case presets are available through useCase or createUseCasePreset():
privacy-firstanalytics-litelogin-riskcheckout-riskbot-defensefraud-defenseIdentity controls are separate from policy controls:
identity.includeNonHashable: include report-only components in the hash for diagnostics or custom deployments.identity.allowCollectors: restrict identity hashing to a specific collector ID set.identity.denyCollectors: exclude specific collector IDs from identity hashing.Collection confidence and identity confidence are both exposed. confidence.score reflects identity completeness adjusted by platform stability. confidence.collectionQuality reports how much of the allowed collector set succeeded, including report-only sources.
The browser demo in examples/browser.html renders three reports side by side and tracks repeated runs:
id, request metadata, compact confidence, totals, aggregate weights, weights.byComponent, hash checks, risk verdicts, identity/report-only lists, and short results summaries keyed by component ID.All demo outputs are generated from the same IdentifyResult and are ordered by verbosity: ID analysis, compact report, then full report. The compact format includes every collected capability with readable summaries. The ID analysis format keeps every component represented through weight and result maps without dumping raw component objects. The full format additionally embeds the raw result and explainable report. Use the extended profile in the demo to exercise the full collector pack and confirm that report-only changes do not move the stable visitor ID.
See docs/REPORT_FORMATS.md for a field-by-field interpretation guide with one sentence per field.
The debug inspector in examples/inspector.html accepts an IdentifyResult, full demo report JSON, or ID analysis report JSON and explains identity components, report-only components, tamper, bot, and private-mode evidence.
npm run verify runs the full quality gate:
src/**/*.js;Additional docs:
MIT. See LICENSE.
MADEVAL/Fingerprint-JS is a public repo on GitHub by MADEVAL. Browser fingerprinting library.
It declares the MIT license on GitHub.
Its maker tagged it for macOS, Windows and Linux, or as Docker or cross-platform. That is declared by the maker; Take My Repo has not tested it.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-06-30. GitHub counts 0 open issues and pull requests. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
The most advanced free and open-source browser fingerprinting library


Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 50+ tests passed.

A list of Free Software network services and web applications which can be hosted on your own servers
An AI prompt-skill that turns 20 cognitive biases into high-converting marketing copy. Playbooks for ads, landing pages, email, social, webinars, and launches.
Turn dry expert topics into high-engagement content with 7 core angles + 3 foundational lenses. An AI skill for any LLM, any niche, any language.
Native AI inference for PHP 8.3+ - run ONNX, GGUF (llama.cpp) and RubixML models directly in your PHP process via FFI. Chat, streaming, embeddings, RAG and vector search. No Python, no HTTP microservices, no Docker sidecars.
A structured failure-analysis workflow that assumes your plan already failed and works backward to find every reason why. Based on Gary Klein's premortem method (Harvard Business Review), validated by prospective-hindsight research from Wharton and Cornell
AI skill for rewriting machine-generated text to sound human-written across 9 languages. Active v4.1.

Lightweight table extension for Oat UI. Sort, filter, and select rows.
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/MADEVAL/Fingerprint-JSTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.