Struct BrowserHost 

pub struct BrowserHost {
    pub status: Arc<Mutex<PageStatus>>,
    pub host_state: HostState,
    /* private fields */
}

Main host-side entry point: Wasmtime engine, shared tab status, and guest-facing host state.

Use BrowserHost::new on the UI thread, then BrowserHost::fetch_and_run or BrowserHost::run_bytes to load modules. BrowserHost::recreate builds a second host that shares HostState and PageStatus for background workers.

Fields

status: Arc<Mutex<PageStatus>>

Latest PageStatus for this tab, safe to share with worker threads via Arc and Mutex.

host_state: HostState

Sandbox resources and host imports: module loader, KV/bookmarks, canvas, timers, console, etc.

Implementations

impl BrowserHost

pub fn new() -> Result<Self>

Creates a new host with default SandboxPolicy, a persistent KV store under the platform data directory, and an initialized BookmarkStore.

pub fn recreate(host_state: HostState, status: Arc<Mutex<PageStatus>>) -> Self

Re-creates a BrowserHost that shares the given HostState and PageStatus.

Used when worker threads need their own WasmEngine / Wasmtime instance while keeping bookmarks, KV, canvas handles, and tab status in sync with the main host.

pub async fn fetch_and_run(&mut self, url: &str) -> Result<Option<LiveModule>>

Fetches a .wasm from url, compiles it, links the oxide imports, runs start_app(), and returns a LiveModule if the guest exports on_frame.

Updates PageStatus to PageStatus::Loading then PageStatus::Running on success. Supports http/https (network fetch) and file:// (local read) via OxideUrl parsing; other schemes error.

pub fn run_bytes(&mut self, wasm_bytes: &[u8]) -> Result<Option<LiveModule>>

Compiles and runs wasm_bytes like fetch_and_run, but without a network fetch—useful for in-memory or locally read modules.

Sets PageStatus::Running with a "(local)" label. Returns Some with a LiveModule when on_frame is exported, otherwise None.