npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

fpscanner

v0.1.5

Published

Detect bots using fingerprinting

Downloads

730

Readme

Fingerprint Scanner

Build Status

Library to detect bots and crawlers using browser fingerprinting.

You can see it in action on this page.

Attributes collected

Fingerprint Scanner relies on Fp-Collect to collect a browser fingerprint. Since the purpose of the library is bot detection, it doesn't detect collect unnecessary fingerprint attributes used for tracking.

Usage

Installation

npm install fpscanner

Detect bots

In order to use Fingerprint-Scanner your need to pass a fingerprint collected using the fp-collect library. Then, we can analyze the fingerprint with the scanner.

const scanner = require('fpScanner');
//fingerprint is the fingerprint collected with fp-collect
scannerResults = scanner.analyseFingerprint(fingerprint);

// Name of the first test
console.log(scannerResults[0].name); 
// PHANTOM_UA

// Result of the test
console.log(scannerResults[0].consistent);
// Either 1 (Inconsistent), 2 (Unsure) or 3 (Consistent)

// Data related with the test
console.log(scannerResults[0].data);
// User agent of the browser

analyseFingerprint returns an array of analysisResult's objects. Each object contains the following information:

  • name: the name of the test;
  • consistent: the result of the test (CONSISTENT, UNSURE, INCONSISTENT)
  • data: data related to the test

Detection tests

Summary of the tests used to detect bots. For more details, visit the documentation page (coming soon).

  • PHANTOM_UA: Detect PhantomJS user agent
  • PHANTOM_PROPERTIES: Test the presence of properties introduced by PhantomJS
  • PHANTOM_ETSL: Runtime verification for PhantomJS
  • PHANTOM_LANGUAGE: Use navigator.languages to detect PhantomJS
  • PHANTOM_WEBSOCKET: Analyze the error thrown when creating a websocket
  • MQ_SCREEN: Use media query related to the screen
  • PHANTOM_OVERFLOW: Analyze error thrown when a stack overflow occurs
  • PHANTOM_WINDOW_HEIGHT: Analyze window screen dimension
  • HEADCHR_UA: Detect Chrome Headless user agent
  • WEBDRIVER: Test the presence of webriver attributes
  • HEADCHR_CHROME_OBJ: Test the presence of the window.chrome object
  • HEADCHR_PERMISSIONS: Test permissions management
  • HEADCHR_PLUGINS: Verify the number of plugins
  • HEADCHR_IFRAME: Test presence of Chrome Headless using an iframe
  • CHR_DEBUG_TOOLS: Test if debug tools are opened
  • SELENIUM_DRIVER: Test the presence of Selenium drivers
  • CHR_BATTERY: Test the presence of battery
  • CHR_MEMORY: Verify if navigator.deviceMemory is consistent
  • TRANSPARENT_PIXEL: Verify if a canvas pixel is transparent

Acknowledgements

We would like to thank CrossBrowserTesting for providing us an easy way to test our scanner on different platforms to reduce false positives.

Logo of CrossBrowserTesting