Struct EngineRuntime 

pub struct EngineRuntime { /* private fields */ }

Owns the engine thread and exposes a synchronous facade.

Drop semantics: dropping the runtime closes the command channel, which causes the engine thread to exit its loop and drop the engine. The destructor joins the thread.

Implementations

impl EngineRuntime

pub fn spawn<F>(make: F) -> EngineResult<Self>

where F: FnOnce() -> EngineResult<Box<dyn Engine>> + Send + 'static,

Spawn the engine thread and construct the engine on that thread via make. This is the only correct construction point: the platform run loop must be initialized on the same thread that later drives WebKit.

Returns once the engine thread has signaled it is ready.

pub fn dispatcher(engine: Box<dyn Engine>) -> (Self, MainThreadDispatcher)

Construct a runtime whose engine runs on the caller’'‘s thread. No internal thread is spawned. The returned MainThreadDispatcher drives the engine: call MainThreadDispatcher::tick in the caller’'’s loop to drain one queued job, or [MainThreadDispatcher::run_until] to block until a stop flag fires.

Use this when the engine is bound to a specific OS thread (e.g. the macOS Cocoa main thread, where WKWebView must run).

pub fn shutdown(&mut self)

Cleanly shut down: close the channel and join the thread. Idempotent — calling shutdown twice is a no-op.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub fn cursor_op( &self, page: PageHandle, op: CursorOp, mode: InputMode, ) -> EngineResult<()>

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

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

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

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

pub fn capabilities(&self) -> EngineResult<EngineCapabilities>

Trait Implementations

impl Debug for EngineRuntime

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

Formats the value using the given formatter.

impl Drop for EngineRuntime

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.