Struct ContextRouteRegistry 

pub struct ContextRouteRegistry { /* private fields */ }

Context-level route handler registry.

Routes registered here apply to all pages in the context. New pages automatically inherit these routes.

Implementations

impl ContextRouteRegistry

pub fn new(connection: Arc<CdpConnection>, context_id: String) -> Self

Create a new context route registry.

pub async fn register_page_registry(&self, registry: &Arc<RouteHandlerRegistry>)

Register a page’s route registry with this context.

When a new route is added to the context, Fetch will be enabled on all registered page registries before the route() call returns.

pub fn subscribe_route_changes(&self) -> Receiver<RouteChangeNotification>

Subscribe to route change notifications.

Pages use this to know when they need to enable Fetch domain for newly added context routes.

pub async fn route<M, H, Fut>( &self, pattern: M, handler: H, ) -> Result<(), NetworkError>

where M: Into<UrlPattern>, H: Fn(Route) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), NetworkError>> + Send + 'static,

Register a route handler for the given pattern.

The handler will be applied to all pages in the context.

Errors

Returns an error if registering the route handler fails.

pub async fn route_predicate<P, H, Fut>( &self, predicate: P, handler: H, ) -> Result<(), NetworkError>

where P: Fn(&str) -> bool + Send + Sync + 'static, H: Fn(Route) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<(), NetworkError>> + Send + 'static,

Register a route handler with a predicate function.

Errors

Returns an error if registering the route handler fails.

pub async fn unroute(&self, pattern: &str)

Unregister handlers matching the given pattern.

pub async fn unroute_all(&self)

Unregister all handlers.

pub async fn has_routes(&self) -> bool

Check if there are any registered routes.

pub async fn route_count(&self) -> usize

Get the number of registered routes.

pub async fn apply_to_page( &self, page_registry: &RouteHandlerRegistry, ) -> Result<(), NetworkError>

👎Deprecated: Use set_context_routes on RouteHandlerRegistry instead

Apply context routes to a page’s route registry.

This should be called when a new page is created to copy context routes to the page.

Errors

Returns an error if applying routes to the page fails.

pub async fn find_handler( &self, url: &str, ) -> Option<Arc<dyn Fn(Route) -> Pin<Box<dyn Future<Output = Result<(), NetworkError>> + Send>> + Send + Sync>>

Try to handle a request with context routes.

Returns Some(handler) if a matching handler is found, None otherwise. This is called by page route registries as a fallback.

pub async fn find_all_handlers( &self, url: &str, ) -> Vec<Arc<dyn Fn(Route) -> Pin<Box<dyn Future<Output = Result<(), NetworkError>> + Send>> + Send + Sync>>

Find all matching handlers for a URL.

Returns all handlers that match the URL in reverse order (LIFO). This is used for fallback chaining - handlers are tried in order until one handles the request.

Trait Implementations

impl Debug for ContextRouteRegistry

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

Formats the value using the given formatter.