Struct WebRtcConfig 

pub struct WebRtcConfig {
    pub policy: WebRtcPolicy,
    pub public_ip: Option<String>,
    pub local_ip: Option<String>,
    pub location: Option<ProxyLocation>,
}

WebRTC leak-prevention and geolocation consistency configuration.

Produces both a JavaScript injection script (to run before page load) and Chrome launch arguments that enforce the chosen WebRtcPolicy.

Example

use stygian_browser::webrtc::{WebRtcConfig, WebRtcPolicy};

let cfg = WebRtcConfig::default();
assert_eq!(cfg.policy, WebRtcPolicy::DisableNonProxied);
let args = cfg.chrome_args();
assert!(args.iter().any(|a| a.contains("disable_non_proxied_udp")));

Fields

policy: WebRtcPolicy

WebRTC IP-handling policy.

public_ip: Option<String>

Fake public IP address to substitute in WebRTC SDP when using WebRtcPolicy::BlockAll. Use an IP plausible for the proxy region. Has no effect when WebRtcPolicy::AllowAll or WebRtcPolicy::DisableNonProxied is selected.

local_ip: Option<String>

Fake LAN IP address to substitute in WebRTC SDP when using WebRtcPolicy::BlockAll.

location: Option<ProxyLocation>

Optional geographic location to inject via navigator.geolocation. When None, geolocation is not overridden.

Implementations

impl WebRtcConfig

pub fn is_permissive(&self) -> bool

Returns true when WebRTC is not being restricted at all.

Example

use stygian_browser::webrtc::{WebRtcConfig, WebRtcPolicy};

let cfg = WebRtcConfig { policy: WebRtcPolicy::AllowAll, ..Default::default() };
assert!(cfg.is_permissive());

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

Chrome launch arguments that enforce the selected WebRtcPolicy.

Returns an empty Vec for WebRtcPolicy::AllowAll since no Chrome flag is needed in that case.

Example

use stygian_browser::webrtc::{WebRtcConfig, WebRtcPolicy};

let cfg = WebRtcConfig { policy: WebRtcPolicy::BlockAll, ..Default::default() };
let args = cfg.chrome_args();
assert!(args.iter().any(|a| a.contains("disable_non_proxied_udp")));

pub fn injection_script(&self) -> String

JavaScript injection script that overrides RTCPeerConnection and optionally overrides navigator.geolocation.

The generated script is an IIFE (immediately-invoked function expression) designed to be injected via CDP Page.addScriptToEvaluateOnNewDocument.

Example

use stygian_browser::webrtc::{WebRtcConfig, WebRtcPolicy};

let cfg = WebRtcConfig { policy: WebRtcPolicy::BlockAll, ..Default::default() };
let script = cfg.injection_script();
assert!(script.contains("RTCPeerConnection"));

Trait Implementations

impl Clone for WebRtcConfig

fn clone(&self) -> WebRtcConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebRtcConfig

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

Formats the value using the given formatter.

impl Default for WebRtcConfig

fn default() -> WebRtcConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WebRtcConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WebRtcConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.