Struct WebView 

pub struct WebView { /* private fields */ }

WebView type that includes inner implementation and delegate

Implementations

impl WebView

pub const fn native_view_id(&self) -> NativeWebViewId

Opaque identity for this concrete native WebView instance.

It is readable for identity comparison across crates, but cannot be constructed, serialized, or converted to a raw platform handle by consumers.

pub fn prepare_trusted_data_load( &self, ) -> Result<TrustedDataLoadReservation<'_>, WebViewError>

Reserve a trusted native HTML load before starting the native operation.

Register TrustedDataLoadReservation::intent with document state before calling load; a native callback is permitted to arrive before load returns. The reservation’s Drop implementation revokes an unused token. HTML and base URLs are resource-location inputs, never authority.

pub fn current_document_binding(&self) -> DocumentBinding

Read the document binding currently owned by this native WebView.

This is intentionally read-only. Only accepted top-level navigation starts and reliable commits in the event normalizer can change it.

pub fn appid(&self) -> String

Get the appid

pub fn path(&self) -> String

Get the path

pub fn webtag(&self) -> WebTag

Get the webtag (computed from appid and path)

pub fn has_scheme_handler(&self, scheme: &str) -> bool

Check if a scheme handler is registered for the given scheme.

pub fn handle_navigation(&self, request: &NavigationRequest) -> NavigationPolicy

Call the navigation handler. Returns Allow if no handler is registered.

A URL matching an open crate::url_callback channel is delivered to that channel and cancelled before any per-webview handler runs.

pub fn has_new_window_handler(&self) -> bool

Check if a new-window handler is registered.

pub fn handle_new_window(&self, url: &str) -> NewWindowPolicy

Call the new-window handler. Returns Cancel if no handler is registered.

A URL matching an open crate::url_callback channel is delivered to that channel and cancelled before any per-webview handler runs.

pub async fn evaluate_javascript( &self, js: &str, ) -> Result<Value, WebViewScriptError>

pub async fn current_url(&self) -> Result<Option<String>, WebViewError>

pub fn reload(&self) -> Result<(), WebViewError>

pub fn go_back(&self) -> Result<(), WebViewError>

pub fn go_forward(&self) -> Result<(), WebViewError>

pub async fn list_cookies(&self) -> Result<Vec<WebViewCookie>, WebViewError>

pub async fn set_cookie( &self, request: WebViewCookieSetRequest, ) -> Result<(), WebViewError>

pub async fn delete_cookie( &self, name: &str, domain: &str, path: &str, ) -> Result<(), WebViewError>

pub async fn clear_cookies(&self) -> Result<(), WebViewError>

pub async fn start_network_capture(&self) -> Result<(), WebViewError>

pub async fn stop_network_capture(&self) -> Result<(), WebViewError>

pub async fn network_entries( &self, ) -> Result<NetworkCaptureSnapshot, WebViewError>

pub async fn clear_network_capture(&self) -> Result<(), WebViewError>

pub async fn take_screenshot(&self) -> Result<Vec<u8>, WebViewError>

pub async fn click( &self, selector: &str, options: ClickOptions, ) -> Result<(), WebViewInputError>

pub async fn type_text( &self, selector: &str, text: &str, options: TypeOptions, ) -> Result<(), WebViewInputError>

pub async fn fill( &self, selector: &str, text: &str, options: FillOptions, ) -> Result<(), WebViewInputError>

pub async fn press( &self, key: &str, options: PressOptions, ) -> Result<(), WebViewInputError>

pub async fn scroll( &self, dx: f64, dy: f64, options: ScrollOptions, ) -> Result<(), WebViewInputError>

pub async fn scroll_to( &self, selector: &str, options: ScrollOptions, ) -> Result<(), WebViewInputError>

Trait Implementations

impl WebViewController for WebView

fn load_url(&self, url: &str) -> Result<(), WebViewError>

Load a URL in the WebView

fn load_data(&self, request: LoadDataRequest<'_>) -> Result<(), WebViewError>

Load HTML data into the WebView.

fn exec_js(&self, js: &str) -> Result<(), WebViewError>

Execute JavaScript in the WebView without observing its return value.

fn eval_js<'life0, 'life1, 'async_trait>( &'life0 self, js: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Value, WebViewScriptError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Evaluate JavaScript in the WebView and return the decoded JSON value.

fn current_url<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<String>, WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return the platform WebView’s current URL.

fn post_message(&self, message: &str) -> Result<(), WebViewError>

Post a message to the WebView

fn post_message_to_document( &self, expected_generation: DocumentGeneration, gate: Arc<dyn DocumentOutboundGate>, message: &str, ) -> Result<(), WebViewError>

Post a message only if an exact committed document and its session gate are still current.

fn clear_browsing_data(&self) -> Result<(), WebViewError>

Clear browsing data from the WebView

fn set_user_agent_override( &self, user_agent: UserAgentOverride, ) -> Result<(), WebViewError>

Override or restore the WebView user agent.

fn reload(&self) -> Result<(), WebViewError>

Reload the current WebView document.

fn go_back(&self) -> Result<(), WebViewError>

Navigate back in WebView history.

fn go_forward(&self) -> Result<(), WebViewError>

Navigate forward in WebView history.

fn list_cookies<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<WebViewCookie>, WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List HTTP cookies from the platform WebView cookie store.

fn set_cookie<'life0, 'async_trait>( &'life0 self, request: WebViewCookieSetRequest, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Set an HTTP cookie through the platform WebView cookie store.

fn delete_cookie<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 str, domain: &'life2 str, path: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Delete an HTTP cookie from the platform WebView cookie store.

fn clear_cookies<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear all HTTP cookies from the platform WebView cookie store.

fn clear_site_data<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, options: ClearSiteDataOptions, ) -> Pin<Box<dyn Future<Output = Result<ClearSiteDataResult, WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Clear data owned by the current website without clearing the shared browser profile. Platforms report whether their network cache supports site-scoped removal.

fn take_screenshot<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Capture a PNG screenshot of the WebView’s visible content. Returns raw PNG-encoded bytes ready to be base64’d over the wire.

fn start_network_capture<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Begin recording network requests/responses into a bounded per-webview buffer, retrievable via Self::network_entries. Dev-tooling only; implemented on platforms whose WebView exposes an inspection protocol (currently Windows/WebView2 via the Chrome DevTools Protocol).

fn stop_network_capture<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Stop recording network traffic. Captured entries are kept until Self::clear_network_capture or the webview is torn down.

fn network_entries<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<NetworkCaptureSnapshot, WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Snapshot the captured network entries (oldest first). dropped counts entries evicted from the ring buffer since the last clear.

fn clear_network_capture<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Drop all captured entries (leaves capture enabled if it was on).

impl WebViewInputController for WebView

fn click<'life0, 'life1, 'async_trait>( &'life0 self, _selector: &'life1 str, _options: ClickOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn type_text<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _selector: &'life1 str, _text: &'life2 str, _options: TypeOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn fill<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _selector: &'life1 str, _text: &'life2 str, _options: FillOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn press<'life0, 'life1, 'async_trait>( &'life0 self, _key: &'life1 str, _options: PressOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn scroll<'life0, 'async_trait>( &'life0 self, _dx: f64, _dy: f64, _options: ScrollOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn scroll_to<'life0, 'life1, 'async_trait>( &'life0 self, _selector: &'life1 str, _options: ScrollOptions, ) -> Pin<Box<dyn Future<Output = Result<(), WebViewInputError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,