Struct PacResolver 

pub struct PacResolver { /* private fields */ }

Available on crate features js and pac and std only.

Evaluates a PAC script to decide how a request should be proxied.

The script comes from a provider on every lookup, and the worker is only rebuilt when the script actually changed — so an always-fetching provider stays affordable and a swapped script takes effect at once.

Implementations

impl PacResolver

pub fn builder() -> PacResolverBuilder

Create a PacResolverBuilder.

pub async fn find_proxy( &self, uri: &Uri, ) -> Result<PacDirectives, Box<dyn Error + Send + Sync>>

The proxies to try for uri, in the order the script named them.

The script is fetched from the provider, compiled once, and evaluated per call; it is recompiled only when the provider serves different bytes. What the script may spend while answering is bounded — see the crate docs.

impl PacResolver

pub const DEFAULT_EXECUTION_TIME_LIMIT: Duration

Wall-clock limit one FindProxyForURL call gets by default.

pub const MAX_WORKER_SPAWNS_PER_WINDOW: usize = 3

How many js workers may remain at risk within a cooldown window before the resolver stops building them.

A script can wedge its worker in native code no javascript limit can interrupt, which leaks that worker’s thread. Loads and calls remain charged until the worker thread proves they returned; completed work costs nothing. Charges age out of the window on their own, so a script is never written off permanently.

pub const DEFAULT_WEDGE_COOLDOWN: Duration

How long an unresolved worker charge counts against MAX_WORKER_SPAWNS_PER_WINDOW by default.

pub const fn default_timeout_for(limit: Duration) -> Duration

The lookup timeout derived from limit when none was configured: strictly greater than the execution time limit, so a bounded runaway is still reported as such, with room for queue time.

Trait Implementations

impl Debug for PacResolver

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

Formats the value using the given formatter.