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.