Struct WpeBackend 

pub struct WpeBackend { /* private fields */ }

Real WebKitGTK 6 backend. Construct on the GTK main thread; all subsequent calls must come from the same thread.

Implementations

impl WpeBackend

pub fn new() -> Self

Build a backend. Caller must already have initialized GTK on this thread (via gtk4::init()); production wiring lives in vs-cli::serve on Linux. Constructing on a non-GTK thread will panic the first time a WebView operation runs.

pub fn with_capture_dir(self, dir: impl Into<PathBuf>) -> Self

Pin the directory where capture writes PNGs. Defaults to a system temp subdirectory.

Trait Implementations

impl Default for WpeBackend

fn default() -> Self

Returns the “default value” for a type.

impl Engine for WpeBackend

fn open(&mut self, url: &str) -> EngineResult<PageHandle>

Open a fresh page navigated to url.

fn close(&mut self, page: PageHandle) -> EngineResult<()>

Close a page. Idempotent — closing a closed page is a no-op.

fn snapshot(&mut self, page: PageHandle) -> EngineResult<Tree>

Snapshot the a11y tree at page.

fn act( &mut self, page: PageHandle, target: ActTarget, action: Action, ) -> EngineResult<()>

Perform action on target at page.

fn wait( &mut self, page: PageHandle, cond: WaitCondition, budget: Duration, ) -> EngineResult<()>

Wait for cond at page until satisfied or budget elapses.

fn layout( &mut self, page: PageHandle, refs: &[Ref], ) -> EngineResult<Vec<LayoutBox>>

Compute layout boxes for refs at page.

fn set_viewport( &mut self, page: PageHandle, viewport: Viewport, ) -> EngineResult<()>

Set the viewport at page. Triggers a re-baseline for the next snapshot.

fn capture( &mut self, page: PageHandle, _scope: CaptureScope, ) -> EngineResult<PathBuf>

Take a screenshot. Returns the path on disk where the image was written.

fn save_auth(&mut self, page: PageHandle) -> EngineResult<AuthBlob>

Snapshot cookies/storage for page as an opaque AuthBlob.

fn load_auth(&mut self, page: PageHandle, blob: &AuthBlob) -> EngineResult<()>

Apply a previously saved AuthBlob to page.

fn console_entries( &mut self, page: PageHandle, ) -> EngineResult<Vec<ConsoleEntry>>

Snapshot the always-captured console ring buffer for page. Default impl returns empty (engines without console capture).

fn network_entries( &mut self, page: PageHandle, ) -> EngineResult<Vec<NetworkEntry>>

Snapshot the always-captured network ring buffer for page. Default impl returns empty (engines without network capture).

fn request_detail( &mut self, page: PageHandle, seq: u64, ) -> EngineResult<Option<RequestDetail>>

Look up the full detail (headers + bodies) for a single captured network request. Returns None if the seq isn’t in the buffer. Default impl returns None.

fn eval_js(&mut self, page: PageHandle, expr: &str) -> EngineResult<EvalResult>

Evaluate expr in main world. Default impl returns EvalResult::Thrown { kind: "NotImplemented", ... }.

fn storage( &mut self, page: PageHandle, scope: StorageScope, ) -> EngineResult<Vec<StorageEntry>>

List storage entries for the requested scope.

fn scripts(&mut self, page: PageHandle) -> EngineResult<Vec<ScriptEntry>>

List scripts loaded by the page.

fn script_source( &mut self, page: PageHandle, seq: u64, ) -> EngineResult<Option<ScriptSource>>

Source of one script by seq. Returns None if the seq isn’t in the script registry.

fn dom( &mut self, page: PageHandle, r: Ref, extra_props: &[String], ) -> EngineResult<Option<DomDetail>>

Outer HTML + computed styles for a ref. Caller-requested computed properties land in extra_props; the engine merges them with its default property set. Returns None for unknown refs.

fn performance(&mut self, page: PageHandle) -> EngineResult<PerformanceMetrics>

Web Vitals + heap + DOM stats. Returns zero-filled defaults if the engine can’t measure them.

fn cookie_events(&mut self, page: PageHandle) -> EngineResult<Vec<CookieEvent>>

List cookie store ADD/REMOVE events observed since the page opened. Engines without a cookie-changed observer (Windows, the stub) return an empty vec or ENGINE_UNSUPPORTED via their capability flag.

fn capabilities(&self) -> EngineCapabilities

Capabilities the daemon should advertise for this engine.