Struct Route 

pub struct Route { /* private fields */ }

An intercepted network request that can be fulfilled, continued, or aborted.

When a request matches a route pattern, a Route is passed to the handler. The handler must call one of fulfill(), continue_(), abort(), or fallback() to resolve the request.

Implementations

impl Route

pub fn request(&self) -> &Request

Get the intercepted request.

pub async fn is_handled(&self) -> bool

Check if this route has been handled.

pub fn is_response_stage(&self) -> bool

Check if this route is at the response stage.

pub fn response_status(&self) -> Option<u16>

Get the response status code (if at response stage).

pub fn response_headers(&self) -> Option<&[HeaderEntry]>

Get the response headers (if at response stage).

pub async fn response_body(&self) -> Result<Option<Vec<u8>>, NetworkError>

Get the response body (if at response stage).

Errors

Returns an error if not at response stage or body cannot be fetched.

pub fn fulfill(&self) -> FulfillBuilder<'_>

Fulfill the request with a custom response.

Example

route.fulfill()
    .status(200)
    .content_type("application/json")
    .body(r#"{"success": true}"#)
    .send()
    .await?;

pub fn continue_(&self) -> ContinueBuilder<'_>

Continue the request with optional modifications.

Example

// Continue unchanged
route.continue_().await?;

// Modify the request
route.continue_()
    .header("X-Custom", "value")
    .send()
    .await?;

pub async fn abort(&self) -> Result<(), NetworkError>

Abort the request with a generic error.

Errors

Returns an error if the abort fails.

pub async fn abort_with(&self, error: AbortError) -> Result<(), NetworkError>

Abort the request with a specific error.

Errors

Returns an error if the abort fails.

pub async fn fallback(&self) -> Result<(), NetworkError>

Pass this request to the next matching route handler.

If no other handlers match, the request continues to the server.

Errors

Returns an error if the fallback fails.

pub fn fetch(&self) -> FetchBuilder<'_>

Fetch the actual response from the server, allowing inspection/modification.

Example

let response = route.fetch().await?;
println!("Status: {}", response.status);

// Modify and send to page
route.fulfill()
    .response(&response)
    .header("X-Modified", "true")
    .send()
    .await?;

pub async fn fetch_with_timeout( &self, timeout: Duration, ) -> Result<FetchedResponse<'_>, NetworkError>

Fetch the response with a timeout.

Trait Implementations

impl Clone for Route

fn clone(&self) -> Route

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Route

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

Formats the value using the given formatter.