You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
呓喵酱 89d2029825
Update zh.md
3 years ago
.github Create FUNDING.yml 5 years ago
dist v3.0.3 4 years ago
src link fp with cookie 5 years ago
.gitignore v3 4 years ago
CNAME to fp.js.org 3 years ago
LICENSE update LICENSE owner 4 years ago
README.md Update README.md 3 years ago
_config.yml Set theme jekyll-theme-cayman 5 years ago
compile.sh v3 4 years ago
demo.html v3 4 years ago
fingerprint2.js v3 4 years ago
fp.js v3.0.3 4 years ago
fp_old.js v3 4 years ago
package.json Update package.json 4 years ago
zh.md Update zh.md 3 years ago

README.md

fp

FOSSA Status version license download size

The simplified usage of fingerprintjs/fingerprintjs2.

简体中文

What is fp?

fp is a concise web front-end solution to generate an unique 'fingerprint' for each visitor basing on visitor's device and browser. fp is the simplified usage of fingerprintjs/fingerprintjs2. Without complex configuration, fp can provide an optimized fingerprint for user-agents in form of 6 letters hash in a short time.

Quick start

Click here to see how it works!

How to use fp?

Install

npm:

$ npm install fp3 --save

yarn:

$ yarn add fp3

Cite in HTML:

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/fp3/dist/fp.min.js"></script>

Generate fp

This is a demo to generate fp:

<script type="text/javascript">
  ;(async function(){
    alert(await fp);
  })()
</script>

This will generate a six-letter hash like this (For difficult client this hash is unique):

df3kd0

The first two letters df indicates the fingerprint of the device, such as the PC, phone etc. Ideally, these two letter will not vary while you switch the browser on the same device.

The middle two letters 3k and the last two letters d0 are the fingerprint of the browser. The different is that, the last one could vary with the change of timezone, plugin etc., while the middle one is more stable and will not vary under these stuation. However, the middle part is more likely to be "not unique" when you have a great amount of clients.

In practice, you can use substr() to decompose fp into each part.

  ;(async function(){
    var fp_device = (await fp).substr(0, 2);  //df in df3kd0
    var fp_browser = (await fp).substr(2, 2); //3k in df3kd0
    var fp_unique = (await fp).substr(4);     //d0 in df3kd0
  })()

Advanced Usage

Get fp details

<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/fp3/dist/fp.min.js"></script>
<script type="text/javascript">
  ;(async function(){
    console.log(await fp_details);
  })()
</script>

CDN

  • jsdelivr: https://cdn.jsdelivr.net/npm/fp3/dist/fp.min.js
  • China: https://cdn.yimian.xyz/fp/fp.min.js

License

FOSSA Status