Struct Fingerprint 

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>,
}

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

impl Fingerprint

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);

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());

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());

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());

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"));

Trait Implementations

impl Clone for Fingerprint

fn clone(&self) -> Fingerprint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Fingerprint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Fingerprint

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Fingerprint

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Fingerprint

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.