v1.7.0

Minor Changes

• Added support for Fingerprint JavaScript agent v4. Compatibility with JavaScript agent v3 is maintained, you can upgrade to the latest JavaScript agent at your convenience.

  When upgrading to the JavaScript agent v4, remove the scriptUrlPattern and endpoint options. Replace them with a single endpoints option pointing to the worker route of your Cloudflare proxy integration:

  - const fpPromise = FingerprintJS.load({
  -   apiKey: PUBLIC_API_KEY,
  -   scriptUrlPattern: "https://yourwebsite.com/WORKER_PATH/AGENT_SCRIPT_DOWNLOAD_PATH?apiKey=<apiKey>&version=<version>&loaderVersion=<loaderVersion>",
  -   endpoint: "https://yourwebsite.com/WORKER_PATH/GET_RESULT_PATH?region=eu",
  - });
  
  + const fpPromise = Fingerprint.start({
  +   apiKey: PUBLIC_API_KEY,
  +   endpoints: "https://yourwebsite.com/WORKER_PATH/?region=eu",
  + });

  See Migrating the JavaScript agent from v3 to v4 for more details. (b3d8ba5)

v1.7.0-rc.2

Patch Changes

• normalize INTEGRATION_PATH_DEPTH to number and allow 0 (4d60ccc)

v1.7.0-rc.1

Patch Changes

• Add support for INTEGRATION_PATH_DEPTH environment variable (6b07e25)

v1.7.0-rc.0

Minor Changes

• Add support for API V4 (b3d8ba5)

v1.6.0

1.6.0 (2025-03-19)

Features

• proxy integration headers handling when proxy secret is missing (e8c1948)
• remove hard-coded proxy endpoints, introduce config in build (f5e91c2)

Bug Fixes

• correctly resolve client IP from headers (97f2515)

Performance Improvements

• updated Cloudflare worker runtime compabilitiy date (07eaaba)

v1.6.0-rc.2

1.6.0-rc.2 (2025-03-18)

Features

• proxy integration headers handling when proxy secret is missing (e8c1948)

Bug Fixes

• correctly resolve client IP from headers (97f2515)

v1.5.0

1.5.0 (2023-12-13)

Features

• proxy-host-header: add proxy host header (5022e7d)

Bug Fixes

• improve endpoint creation (5414d7f)

Build System

• deps: remove punycode & suffix list (67d0e5a)

v1.5.0-rc.2

1.5.0-rc.2 (2023-12-13)

Bug Fixes

• improve endpoint creation (5414d7f)

v1.5.0-rc.1

1.5.0-rc.1 (2023-12-11)

Features

• proxy-host-header: add proxy host header (5022e7d)

Build System

• deps: remove punycode & suffix list (67d0e5a)

v1.4.0

1.4.0 (2023-07-04)

Features

• cachingendpoint: do not set edge network cache and do not override cache-control (072faa4)
• handleingressapi: handleIngressAPI now proxies req to servers with suffix (a26cd8f)
• ingress-api: add cache-control header to ingress api (1ad08e0)
• ingress-api: support for get/post methods (b217028)
• ingressapi: ingressAPI now handles suffixed routes (acd4af4)
• router: router now provides RegExpMatchArray as 3rd argument to handlers (003005c)