Struct ProfileEmulateLayer 

pub struct ProfileEmulateLayer<P = Arc<UserAgentDatabase>> { /* private fields */ }

Available on crate features std and ua only.

Select a captured profile and publish its immutable emulation context.

Requests without an explicit RequestInitiator select a top-level navigation flow. Missing Sec-Fetch-* headers do not constrain selection; the chosen captured navigation supplies its profile-owned Fetch metadata.

The selected identity follows the configured ProfileSelector, completed by a UserAgent request extension or, with auto-detection, the request’s own User-Agent header.

A request keeps parts of its own identity with the PreserveHeaderUserAgent and PreserveClientHints extensions, or a UserAgent extension whose HTTP or TLS agent is Preserve. Each kept part is listed in the request’s ProfilePreservationReport and never fails the request.

Implementations

impl<P> ProfileEmulateLayer<P>

pub fn new(source: P) -> ProfileEmulateLayer<P>

pub fn with_selector(self, selector: ProfileSelector) -> ProfileEmulateLayer<P>

Restrict captured profile selection.

pub fn set_selector( &mut self, selector: ProfileSelector, ) -> &mut ProfileEmulateLayer<P>

Restrict captured profile selection.

pub fn maybe_with_seed( self, seed: Option<ProfileSeed>, ) -> ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn maybe_set_seed( &mut self, seed: Option<ProfileSeed>, ) -> &mut ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn with_seed(self, seed: ProfileSeed) -> ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn set_seed(&mut self, seed: ProfileSeed) -> &mut ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn without_seed(self) -> ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn unset_seed(&mut self) -> &mut ProfileEmulateLayer<P>

Fix the profile seed for reproducible selection.

pub fn maybe_with_connection_key( self, key: Option<DrawKey>, ) -> ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn maybe_set_connection_key( &mut self, key: Option<DrawKey>, ) -> &mut ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn with_connection_key(self, key: DrawKey) -> ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn set_connection_key( &mut self, key: DrawKey, ) -> &mut ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn without_connection_key(self) -> ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn unset_connection_key(&mut self) -> &mut ProfileEmulateLayer<P>

Fix the logical connection draw key.

pub fn maybe_with_request_key( self, key: Option<DrawKey>, ) -> ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn maybe_set_request_key( &mut self, key: Option<DrawKey>, ) -> &mut ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn with_request_key(self, key: DrawKey) -> ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn set_request_key(&mut self, key: DrawKey) -> &mut ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn without_request_key(self) -> ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn unset_request_key(&mut self) -> &mut ProfileEmulateLayer<P>

Fix the logical request draw key.

pub fn with_pins(self, pins: VariantPins) -> ProfileEmulateLayer<P>

Pin stored connection and request variants.

pub fn set_pins(&mut self, pins: VariantPins) -> &mut ProfileEmulateLayer<P>

Pin stored connection and request variants.

pub fn with_is_optional(self, optional: bool) -> ProfileEmulateLayer<P>

Pass requests through unchanged, with a debug trace, when they cannot be emulated instead of failing them.

pub fn set_is_optional(&mut self, optional: bool) -> &mut ProfileEmulateLayer<P>

Pass requests through unchanged, with a debug trace, when they cannot be emulated instead of failing them.

pub fn with_try_auto_detect_user_agent( self, detect: bool, ) -> ProfileEmulateLayer<P>

Derive the UserAgent from the request’s User-Agent header when no UserAgent extension is present, so a client is emulated as itself.

pub fn set_try_auto_detect_user_agent( &mut self, detect: bool, ) -> &mut ProfileEmulateLayer<P>

Derive the UserAgent from the request’s User-Agent header when no UserAgent extension is present, so a client is emulated as itself.

pub fn with_select_fallback( self, fallback: ProfileSelectFallback, ) -> ProfileEmulateLayer<P>

Choose how to relax the selector when no profile matches it.

pub fn set_select_fallback( &mut self, fallback: ProfileSelectFallback, ) -> &mut ProfileEmulateLayer<P>

Choose how to relax the selector when no profile matches it.

pub fn maybe_with_input_header_order( self, name: Option<HeaderName>, ) -> ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

pub fn maybe_set_input_header_order( &mut self, name: Option<HeaderName>, ) -> &mut ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

pub fn with_input_header_order(self, name: HeaderName) -> ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

pub fn set_input_header_order( &mut self, name: HeaderName, ) -> &mut ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

pub fn without_input_header_order(self) -> ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

pub fn unset_input_header_order(&mut self) -> &mut ProfileEmulateLayer<P>

Name a request header holding a comma-separated list of header names.

Caller headers the profile does not own are emitted in that order, ahead of other caller headers. The header itself is removed from the request.

Trait Implementations

impl<P> Clone for ProfileEmulateLayer<P>

where P: Clone,

fn clone(&self) -> ProfileEmulateLayer<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Debug for ProfileEmulateLayer<P>

where P: Debug,

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

Formats the value using the given formatter.

impl<S, P> Layer<S> for ProfileEmulateLayer<P>

where P: Clone,

type Service = ProfileEmulateService<S, P>

The service produced by the layer.

fn layer(&self, inner: S) -> <ProfileEmulateLayer<P> as Layer<S>>::Service

Wrap the given service with the middleware, returning a new service.

fn into_layer(self, inner: S) -> <ProfileEmulateLayer<P> as Layer<S>>::Service

Same as layer but consuming self after the service was created.