Struct Fingerprint

Source

pub struct Fingerprint {
    pub user_agent: String,
    pub screen_resolution: (u32, u32),
    pub timezone: String,
    pub language: String,
    pub platform: String,
    pub hardware_concurrency: u32,
    pub device_memory: u32,
    pub webgl_vendor: Option<String>,
    pub webgl_renderer: Option<String>,
    pub canvas_noise: bool,
    pub fonts: Vec<String>,
}

Expand description

A complete browser fingerprint used to make each session look unique.

§Example

use stygian_browser::fingerprint::Fingerprint;

let fp = Fingerprint::random();
let (w, h) = fp.screen_resolution;
assert!(w > 0 && h > 0);

Fields§

§user_agent: String

Full user-agent string.

§screen_resolution: (u32, u32)

Physical screen resolution (width, height) in pixels.

§timezone: String

IANA timezone identifier, e.g. "America/New_York".

§language: String

BCP 47 primary language tag, e.g. "en-US".

§platform: String

Navigator platform string, e.g. "MacIntel" or "Win32".

§hardware_concurrency: u32

Logical CPU core count reported to JavaScript.

§device_memory: u32

Device memory in GiB reported to JavaScript.

§webgl_vendor: Option<String>

WebGL GL_VENDOR string.

§webgl_renderer: Option<String>

WebGL GL_RENDERER string.

§canvas_noise: bool

Whether to inject imperceptible canvas pixel noise.

§fonts: Vec<String>

System fonts available on this device.

Populated by Fingerprint::from_device_profile. Empty when created via Fingerprint::random or Default.

Implementations§

Source §

impl Fingerprint

Source

pub fn random() -> Self

Generate a realistic randomised fingerprint.

Values are selected from curated pools representative of real-world browser distributions. Each call uses sub-second system entropy so consecutive calls within the same second may differ.

§Example

use stygian_browser::fingerprint::Fingerprint;

let fp = Fingerprint::random();
assert!(fp.hardware_concurrency > 0);
assert!(fp.device_memory > 0);

Source

pub fn from_profile(profile: &FingerprintProfile) -> Self

Clone a fingerprint from a FingerprintProfile.

§Example

use stygian_browser::fingerprint::{Fingerprint, FingerprintProfile};

let profile = FingerprintProfile::new("test".to_string());
let fp = Fingerprint::from_profile(&profile);
assert!(!fp.user_agent.is_empty());

Source

pub fn from_device_profile(device: DeviceProfile, seed: u64) -> Self

Generate a fingerprint consistent with a specific DeviceProfile.

All properties — user agent, platform, GPU, fonts — are internally consistent. A Mac profile will never carry a Windows GPU, for example.

§Example

use stygian_browser::fingerprint::{Fingerprint, DeviceProfile};

let fp = Fingerprint::from_device_profile(DeviceProfile::DesktopMac, 42);
assert_eq!(fp.platform, "MacIntel");
assert!(!fp.fonts.is_empty());

Source

pub fn validate_consistency(&self) -> Vec<String>

Check that all fingerprint fields are internally consistent.

Returns a Vec<String> of human-readable inconsistency descriptions. An empty vec means the fingerprint passes every check.

§Example

use stygian_browser::fingerprint::Fingerprint;

let fp = Fingerprint::default();
assert!(fp.validate_consistency().is_empty());

Source

pub fn injection_script(&self) -> String

Produce a JavaScript IIFE that spoofs browser fingerprint APIs.

The returned script is intended to be passed to the CDP command Page.addScriptToEvaluateOnNewDocument so it runs before page JS.

Covers: screen dimensions, timezone, language, hardware concurrency, device memory, WebGL parameters, canvas noise, and audio fingerprint defence.

§Example

use stygian_browser::fingerprint::Fingerprint;

let fp = Fingerprint::default();
let script = fp.injection_script();
assert!(script.contains("1920"));
assert!(script.contains("screen"));