Struct ClientHints 

pub struct ClientHints { /* private fields */ }

Client Hints generated from a User-Agent string.

This struct contains all the information needed to construct Sec-CH-UA headers for HTTP requests.

Implementations

impl ClientHints

pub fn from_ua(user_agent: &str) -> Result<Self, ParseError>

Parse a User-Agent string and generate corresponding Client Hints.

Arguments

• user_agent - The User-Agent string to parse

Returns

Returns Ok(ClientHints) if parsing succeeds, or Err(ParseError) if the User-Agent string cannot be parsed or is not from a Chromium-based browser.

Example

use mimic_rs::ClientHints;

let ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36";
let hints = ClientHints::from_ua(ua).unwrap();
assert_eq!(hints.major_version(), 120);

pub fn new( brand: Brand, major_version: u32, full_version: impl Into<String>, platform: Platform, is_mobile: bool, ) -> Self

Create ClientHints with explicit values.

Use this when you already know the browser details and don’t need to parse a UA string.

Example

use mimic_rs::{ClientHints, Brand, Platform};

let hints = ClientHints::new(Brand::Chrome, 120, "120.0.0.0", Platform::Windows, false);

pub const fn brand(&self) -> Brand

Returns the detected browser brand.

pub const fn major_version(&self) -> u32

Returns the major version number.

pub fn full_version(&self) -> &str

Returns the full version string.

pub const fn platform(&self) -> Platform

Returns the detected platform.

pub const fn is_mobile(&self) -> bool

Returns whether this is a mobile browser.

pub fn sec_ch_ua(&self) -> String

Generate the sec-ch-ua header value.

This includes the greased brand, Chromium brand, and the actual browser brand in a randomized order based on the version number.

Example

use mimic_rs::ClientHints;

let ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 Chrome/120.0.0.0 Safari/537.36";
let hints = ClientHints::from_ua(ua).unwrap();
let sec_ch_ua = hints.sec_ch_ua();
// Output: "Not A(Brand";v="8", "Chromium";v="120", "Google Chrome";v="120"

pub fn sec_ch_ua_full_version_list(&self) -> String

Generate the sec-ch-ua-full-version-list header value.

Similar to sec_ch_ua() but uses the full version string instead of just the major version.

pub const fn sec_ch_ua_mobile(&self) -> &'static str

Generate the sec-ch-ua-mobile header value.

Returns ?1 for mobile browsers, ?0 for desktop browsers.

pub fn sec_ch_ua_platform(&self) -> String

Generate the sec-ch-ua-platform header value.

Returns the platform name in quotes (e.g., "Windows").

pub fn all_headers(&self) -> (String, &'static str, String)

Generate all standard Client Hints headers.

Returns a tuple of (sec-ch-ua, sec-ch-ua-mobile, sec-ch-ua-platform).

Trait Implementations

impl Clone for ClientHints

fn clone(&self) -> ClientHints

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientHints

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

Formats the value using the given formatter.

impl PartialEq for ClientHints

fn eq(&self, other: &ClientHints) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ClientHints

impl StructuralPartialEq for ClientHints