Struct Route 

pub struct Route { /* private fields */ }

Route represents a network route handler.

Routes allow intercepting, aborting, continuing, or fulfilling network requests.

See: https://playwright.dev/docs/api/class-route

Implementations

impl Route

pub fn new( parent: Arc<dyn ChannelOwner>, type_name: String, guid: Arc<str>, initializer: Value, ) -> Result<Self>

Creates a new Route from protocol initialization

This is called by the object factory when the server sends a __create__ message for a Route object.

pub fn request(&self) -> Request

Returns the request that is being routed.

See: https://playwright.dev/docs/api/class-route#route-request

pub async fn abort(&self, error_code: Option<&str>) -> Result<()>

Aborts the route’s request.

Arguments

• error_code - Optional error code (default: “failed”)

Available error codes:

• “aborted” - User-initiated cancellation
• “accessdenied” - Permission denied
• “addressunreachable” - Host unreachable
• “blockedbyclient” - Client blocked request
• “connectionaborted”, “connectionclosed”, “connectionfailed”, “connectionrefused”, “connectionreset”
• “internetdisconnected”
• “namenotresolved”
• “timedout”
• “failed” - Generic error (default)

See: https://playwright.dev/docs/api/class-route#route-abort

pub async fn continue_(&self, overrides: Option<ContinueOptions>) -> Result<()>

Continues the route’s request with optional modifications.

Arguments

• overrides - Optional modifications to apply to the request

See: https://playwright.dev/docs/api/class-route#route-continue

pub async fn fulfill(&self, options: Option<FulfillOptions>) -> Result<()>

Fulfills the route’s request with a custom response.

Arguments

• options - Response configuration (status, headers, body, etc.)

Known Limitations

Response body fulfillment is not supported in Playwright 1.49.0 - 1.56.1.

The route.fulfill() method can successfully send requests for status codes and headers, but the response body is not transmitted to the browser JavaScript layer. This applies to ALL request types (main document, fetch, XHR, etc.), not just document navigation.

Investigation Findings:

• The protocol message is correctly formatted and accepted by the Playwright server
• The body bytes are present in the fulfill() call
• The Playwright server creates a Response object
• But the body content does not reach the browser’s fetch/network API

This appears to be a limitation or bug in the Playwright server implementation. Tested with versions 1.49.0 and 1.56.1 (latest as of 2025-11-10).

TODO: Periodically test with newer Playwright versions for fix. Workaround: Mock responses at the HTTP server level rather than using network interception, or wait for a newer Playwright version that supports response body fulfillment.

See: https://playwright.dev/docs/api/class-route#route-fulfill

Trait Implementations

impl ChannelOwner for Route

fn guid(&self) -> &str

Returns the unique GUID for this object.

fn type_name(&self) -> &str

Returns the protocol type name (e.g., “Browser”, “Page”).

fn parent(&self) -> Option<Arc<dyn ChannelOwner>>

Returns the parent object, if any.

fn connection(&self) -> Arc<dyn ConnectionLike>

Returns the connection this object belongs to.

fn initializer(&self) -> &Value

Returns the raw initializer JSON from the server.

fn channel(&self) -> &Channel

Returns the channel for RPC communication.

fn dispose(&self, reason: DisposeReason)

Disposes this object and all its children.

fn adopt(&self, child: Arc<dyn ChannelOwner>)

Adopts a child object (moves from old parent to this parent).

fn add_child(&self, guid: Arc<str>, child: Arc<dyn ChannelOwner>)

Adds a child object to this parent’s registry.

fn remove_child(&self, guid: &str)

Removes a child object from this parent’s registry.

fn on_event(&self, _method: &str, _params: Value)

Handles a protocol event sent to this object.

fn was_collected(&self) -> bool

Returns true if this object was garbage collected.

fn as_any(&self) -> &dyn Any

Enables downcasting to concrete types.

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.