Skip to content

Device context and fingerprint

Device context

Sent once per session in the handshake. Coarse context, used to tell desktop from mobile sessions:

Field Source
screen_w screen_h screen.width, screen.height
viewport_w viewport_h innerWidth, innerHeight
dpr devicePixelRatio
tz IANA time zone
lang navigator.language
cores navigator.hardwareConcurrency
touch_points navigator.maxTouchPoints
pointer_fine matchMedia("(pointer: fine)")
ua_mobile Client Hints mobile flag, else a /Mobi/ test on the user agent

Fingerprint

With fingerprint: true (the default), device.fp adds the signals the API uses to recognise the user's devices. Large values are sent as 53-bit hashes. It takes 0.4 to 0.9 s in a desktop browser and runs before the first upload; events captured meanwhile are kept.

Field Source
canvas Hash of a 2D canvas drawing (text, emoji, blending); with canvas_noisy when two draws differ (the browser randomises reads)
gl_vendor gl_renderer Unmasked WebGL GPU vendor and renderer
gl_params gl_ext Hashes of WebGL limits, shader precisions and supported extensions
audio Sum of an OfflineAudioContext render (oscillator through a compressor)
fonts fonts_n Hash and count of installed fonts among 80 common ones, by text measurement
math Hash of 18 Math function results (engine and platform specific)
ua platform vendor User agent, navigator.platform, navigator.vendor
ch_* Client Hints: platform and version, architecture, bitness, model, browser brands (Chromium)
screen avail dpr Screen size and colour depth, available area, pixel ratio
langs tz tz_offset Languages, time zone, UTC offset
cores mem touch CPU threads, deviceMemory, touch points
media 11 media queries: colour gamut, HDR, forced colours, reduced motion, contrast, hover, pointer
webdriver plugins pdf cookies Automation flag, plugin count, PDF viewer, cookies enabled
ms Time the fingerprint took

The API also records the visitor's IP address at the handshake (from the connection, not from the SDK). The handshake carries page too: origin and path, with no query string or fragment.