pub fn automation_prefs() -> String {
[
r#"user_pref("dom.webdriver.enabled", false);"#,
r#"user_pref("marionette.defaultPrefs.enabled", false);"#,
r#"user_pref("remote.enabled", false);"#,
r#"user_pref("remote.frames.enabled", false);"#,
r#"user_pref("privacy.resistFingerprinting", false);"#,
r#"user_pref("dom.webnotifications.enabled", true);"#,
r#"user_pref("toolkit.shutdown.fastShutdownStage", 0);"#,
r#"user_pref("dom.storage.snapshot_idle_timeout_ms", 500);"#,
]
.join("\n")
}
fn escape_pref_value(s: &str) -> String {
let mut out = String::with_capacity(s.len() + 8);
for c in s.chars() {
match c {
'\\' => out.push_str(r"\\"),
'"' => out.push_str("\\\""),
'\n' => out.push_str(r"\n"),
'\r' => out.push_str(r"\r"),
'\t' => out.push_str(r"\t"),
c => out.push(c),
}
}
out
}
pub fn build_user_js(overrides: &crate::ProfileOverrides) -> String {
let mut lines = Vec::new();
lines.push(format!(
r#"user_pref("general.useragent.override", "{}");"#,
escape_pref_value(&overrides.user_agent)
));
lines.push(format!(
r#"user_pref("general.platform.override", "{}");"#,
escape_pref_value(&overrides.platform)
));
lines.push(format!(
r#"user_pref("general.appversion.override", "{}");"#,
escape_pref_value(crate::fingerprint::firefox_app_version(&overrides.platform))
));
if !overrides.webgl_renderer.is_empty() {
lines.push(format!(
r#"user_pref("webgl.override-unmasked-renderer", "{}");"#,
escape_pref_value(&overrides.webgl_renderer)
));
}
if !overrides.webgl_vendor.is_empty() {
lines.push(format!(
r#"user_pref("webgl.override-unmasked-vendor", "{}");"#,
escape_pref_value(&overrides.webgl_vendor)
));
}
lines.push(format!(
r#"user_pref("intl.accept_languages", "{}");"#,
escape_pref_value(&overrides.languages.join(","))
));
lines.push(automation_prefs());
lines.push(format!(
r#"user_pref("dom.maxHardwareConcurrency", {});"#,
overrides.hardware_concurrency
));
lines.join("\n")
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn automation_prefs_sets_webdriver_disable_pref() {
let p = automation_prefs();
assert!(p.contains(r#"user_pref("dom.webdriver.enabled", false);"#));
}
#[test]
fn automation_prefs_has_no_identity_overrides() {
let p = automation_prefs();
assert!(!p.contains("general.useragent.override"), "must not pin UA");
assert!(
!p.contains("general.platform.override"),
"must not pin platform"
);
assert!(
!p.contains("intl.accept_languages"),
"must not pin languages"
);
assert!(
!p.contains("dom.maxHardwareConcurrency"),
"must not pin hardwareConcurrency"
);
}
#[test]
fn automation_prefs_disables_marionette_and_remote_defaults() {
let p = automation_prefs();
assert!(p.contains("marionette.defaultPrefs.enabled"));
assert!(p.contains("remote.enabled"));
assert!(p.contains("privacy.resistFingerprinting"));
assert!(p.contains("dom.webnotifications.enabled"));
}
#[test]
fn automation_prefs_lines_are_valid_pref_format() {
for line in automation_prefs().lines() {
assert!(
line.starts_with("user_pref(") && line.ends_with(");"),
"invalid pref line: {line}"
);
}
}
#[test]
fn build_user_js_includes_automation_prefs_block() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
for line in automation_prefs().lines() {
assert!(
js.contains(line),
"build_user_js missing automation pref: {line}"
);
}
}
#[test]
fn build_user_js_contains_useragent_override() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("general.useragent.override"));
}
#[test]
fn build_user_js_contains_platform_override() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("general.platform.override"));
}
#[test]
fn build_user_js_appversion_override_is_persona_os_coherent() {
let win = build_user_js(&crate::profile_to_overrides(
&crate::StealthProfile::FirefoxWindows,
));
assert!(
win.contains(r#"user_pref("general.appversion.override", "5.0 (Windows)");"#),
"Windows persona appversion.override not coherent: {win}"
);
let lin = build_user_js(&crate::profile_to_overrides(
&crate::StealthProfile::FirefoxLinux,
));
assert!(
lin.contains(r#"user_pref("general.appversion.override", "5.0 (X11)");"#),
"Linux persona appversion.override not coherent: {lin}"
);
let mac = build_user_js(&crate::profile_to_overrides(
&crate::StealthProfile::FirefoxMacStable,
));
assert!(
mac.contains(r#"user_pref("general.appversion.override", "5.0 (Macintosh)");"#),
"Mac persona appversion.override not coherent: {mac}"
);
}
#[test]
fn build_user_js_contains_languages() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("intl.accept_languages"));
}
#[test]
fn build_user_js_disables_webdriver() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("dom.webdriver.enabled"));
assert!(js.contains("false"));
}
#[test]
fn build_user_js_disables_marionette() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("marionette.defaultPrefs.enabled"));
}
#[test]
fn build_user_js_disables_resist_fingerprinting() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("privacy.resistFingerprinting"));
}
#[test]
fn build_user_js_contains_webnotifications_pref() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("dom.webnotifications.enabled"));
}
#[test]
fn build_user_js_contains_hardware_concurrency() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
assert!(js.contains("dom.maxHardwareConcurrency"));
}
#[test]
fn build_user_js_lines_are_valid_pref_format() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
let js = build_user_js(&overrides);
for line in js.lines() {
if line.trim().is_empty() {
continue;
}
assert!(
line.starts_with("user_pref(") && line.ends_with(");"),
"invalid pref line: {}",
line
);
}
}
#[test]
fn build_user_js_escapes_quotes() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.user_agent = r#"Mozilla/5.0 "test" browser"#.into();
let js = build_user_js(&overrides);
assert!(js.contains(r#"\"test\""#));
}
#[test]
fn build_user_js_empty_languages_does_not_panic() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.languages.clear();
let _ = build_user_js(&overrides);
}
#[test]
fn build_user_js_firefox_windows_profile() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxWindows);
let js = build_user_js(&overrides);
assert!(js.contains("Windows") || js.contains("Win32"));
assert!(js.contains("general.useragent.override"));
}
#[test]
fn build_user_js_chrome_profile_contains_chrome_ua() {
let overrides = crate::profile_to_overrides(&crate::StealthProfile::ChromeWindowsStable);
let js = build_user_js(&overrides);
assert!(js.contains("Chrome/") || js.contains("Chromium"));
}
#[test]
fn build_user_js_empty_user_agent() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.user_agent.clear();
let js = build_user_js(&overrides);
assert!(js.contains(r#"user_pref("general.useragent.override", "");"#));
}
#[test]
fn build_user_js_escapes_newline_in_user_agent() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.user_agent = "line1\nline2".into();
let js = build_user_js(&overrides);
assert!(
js.contains(r"line1\nline2"),
"newline must be escaped to the two-char sequence \\n, got: {js}"
);
assert!(
!js.contains("line1\nline2"),
"a literal newline must not survive inside the pref value"
);
let ua_line = js
.lines()
.find(|l| l.contains("general.useragent.override"))
.expect("UA override line present");
assert!(
ua_line.starts_with("user_pref(") && ua_line.ends_with(");"),
"UA override must be a single valid pref line: {ua_line}"
);
}
#[test]
fn build_user_js_escapes_backslash_and_control_chars() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.user_agent = "a\\b\tc\rd".into();
let js = build_user_js(&overrides);
let ua_line = js
.lines()
.find(|l| l.contains("general.useragent.override"))
.expect("UA override line present");
assert!(
ua_line.contains(r"a\\b"),
"backslash must be doubled: {ua_line}"
);
assert!(ua_line.contains(r"\t"), "tab must be escaped: {ua_line}");
assert!(ua_line.contains(r"\r"), "CR must be escaped: {ua_line}");
assert!(ua_line.starts_with("user_pref(") && ua_line.ends_with(");"));
}
#[test]
fn build_user_js_all_lines_valid_even_with_hostile_override() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.user_agent = "evil\");\nuser_pref(\"dom.webdriver.enabled\", true);//".into();
let js = build_user_js(&overrides);
for line in js.lines().filter(|l| !l.trim().is_empty()) {
assert!(
line.starts_with("user_pref(") && line.ends_with(");"),
"hostile override broke pref-file line structure: {line}"
);
}
assert!(
!js.lines()
.any(|l| l.trim() == r#"user_pref("dom.webdriver.enabled", true);"#),
"override must not be able to inject a separate pref"
);
}
#[test]
fn build_user_js_zero_hardware_concurrency() {
let mut overrides = crate::profile_to_overrides(&crate::StealthProfile::FirefoxLinux);
overrides.hardware_concurrency = 0;
let js = build_user_js(&overrides);
assert!(js.contains("user_pref(\"dom.maxHardwareConcurrency\", 0);"));
}
}