thumbmarkjs
Advanced tools
Comparing version 0.12.1 to 0.15.0
{ | ||
"name": "thumbmarkjs", | ||
"version": "0.12.1", | ||
"version": "0.15.0", | ||
"description": "", | ||
"main": "dist/index.js", | ||
"module": "dist/index.js", | ||
"main": "./dist/thumbmark.cjs.js", | ||
"module": "./dist/thumbmark.esm.js", | ||
"types": "./dist/thumbmark.esm.d.ts", | ||
"exports": { | ||
".": { | ||
"import": "./dist/thumbmark.esm.js", | ||
"require": "./dist/thumbmark.cjs.js" | ||
} | ||
}, | ||
"public": true, | ||
@@ -13,10 +20,23 @@ "files": [ | ||
"test": "jest", | ||
"build": "npx webpack && npx tsc" | ||
"build": "rm -rf dist/* && rm -rf types/* && rollup -c" | ||
}, | ||
"keywords": [ | ||
"fingerprint", "fingerprinting", "browser-fingerprint", "browser-fingerprinting" | ||
"fingerprint", | ||
"fingerprinting", | ||
"browser-fingerprint", | ||
"browser-fingerprinting", | ||
"audio-fingerprinting", | ||
"canvas-fingerprinting", | ||
"visitor-identifier", | ||
"fraud-detection" | ||
], | ||
"author": "Ilkka Peltola", | ||
"license": "MIT", | ||
"unpkg": "dist/thumbmark.umd.js", | ||
"devDependencies": { | ||
"@rollup/plugin-commonjs": "^25.0.7", | ||
"@rollup/plugin-json": "^6.1.0", | ||
"@rollup/plugin-node-resolve": "^15.2.3", | ||
"@rollup/plugin-terser": "^0.4.4", | ||
"@rollup/plugin-typescript": "^11.1.6", | ||
"@testing-library/jest-dom": "^6.1.6", | ||
@@ -33,9 +53,9 @@ "@types/jest": "^29.5.11", | ||
"path": "^0.12.7", | ||
"rollup": "^4.12.0", | ||
"rollup-plugin-dts": "^6.1.0", | ||
"ts-jest": "^29.1.1", | ||
"ts-loader": "^9.5.1", | ||
"ts-md5": "^1.3.1", | ||
"typescript": "^5.3.3", | ||
"webpack": "^5.89.0", | ||
"webpack-cli": "^5.1.4" | ||
"typescript": "^5.3.3" | ||
} | ||
} |
@@ -1,95 +0,5 @@ | ||
# ThumbmarkJS | ||
![GitHub package.json dynamic](https://img.shields.io/github/package-json/version/ilkkapeltola/thumbmarkjs) | ||
![NPM Version](https://img.shields.io/npm/v/thumbmarkjs) | ||
# Outdated | ||
ThumbmarkJS is the world's second best browser fingerprinting JavaScript library. While not (yet?) as good, it's a free open source alternative to the market leading [FingerprintJS](https://github.com/fingerprintjs/fingerprintjs). It is easy to use and easily extendable. | ||
This project has moved to [@thumbmarkjs/thumbmarkjs](https://www.npmjs.com/package/@thumbmarkjs/thumbmarkjs) | ||
ThumbmarkJS is open source (MIT). | ||
## Demo page | ||
You can help this project by visiting the demo page that **logs your fingerprint for analysis**. The logged fingerprint data is only used to improve this library. Visit the page from the link: [Show and log my fingerprint](https://www.thumbmarkjs.com/) | ||
The library works very well to distinguish common browsers. | ||
## Simple usage from CDN | ||
```javascript | ||
<script src="https://cdn.thumbmarkjs.com/latest/Thumbmark.js"></script> | ||
<script> | ||
ThumbmarkJS.getFingerprint().then( | ||
function(fp) { | ||
console.log(fp); | ||
} | ||
); | ||
</script> | ||
<!-- or --> | ||
<script> | ||
import('https://cdn.thumbmarkjs.com/latest/Thumbmark.js') | ||
.then(() => { | ||
ThumbmarkJS.getFingerprint().then((fp) => { console.log(fp)}) | ||
}) | ||
</script> | ||
``` | ||
You can also call `ThumbmarkJS.getFingerprintData()` to get a full JSON object with all its components. | ||
You can also get any previous version from the CDN by replacing `latest` with the version number. Currently the URL would be | ||
`https://cdn.thumbmarkjs.com/0.11.4/Thumbmark.js` | ||
## Install with NPM | ||
Installing from NPM: | ||
```bash | ||
npm install thumbmarkjs | ||
``` | ||
and in your code | ||
```javascript | ||
import { getFingerprint } from 'thumbmarkjs' | ||
``` | ||
But bear in mind that the library is meant to be running in the browser. Let me know if the library fails on a server side import. However, `getFingerprint()` is not meant to be called server side. | ||
## Build it yourself | ||
Clone this repo and then run | ||
``` | ||
npm run install | ||
npm run build | ||
``` | ||
## How you can help | ||
Simply going to the [Show and log my fingerprint](https://www.thumbmarkjs.com/)-page helps a lot. The logging is all anonymous and only used to develop this library. Let me know if you run into any errors by opening an issue. The discussion section is also open. | ||
Test cases you can try: | ||
- Check your fingerprint, then refresh the page with Ctrl + R | ||
- Refresh without cache | ||
- Move the window to another screen | ||
- Try in incognito | ||
if you see a fingerprint change when it shouldn't, you can use [this JSON Diff Finder tool](https://url-decode.com/tool/json-diff) to check what causes the diff. | ||
## Components included in fingerprint | ||
- audio fingerprint | ||
- canvas fingerprint | ||
- webgl fingerprint | ||
- available fonts and how they render | ||
- videocard | ||
- browser languages and time zone | ||
- browser permissions | ||
- available plugins | ||
- a ton of screen details including media queries | ||
- and a bunch of smaller things | ||
## Technical details | ||
I wanted to create something that's easy to build, extend and use. If you're interested in how the library works, the structure is very simple. | ||
Have a look at the [technical_details](technical_details.md) | ||
Please change your links |
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
186556
22
33
348
5
1