Struct BaoRuntime 

pub struct BaoRuntime { /* private fields */ }

Implementations

impl BaoRuntime

pub fn new(config: BaoConfig) -> Result<Self, BrowserError>

pub fn page_pool(&self) -> &Rc<PagePool>

pub fn create_page( &self, config: &PageConfig, ) -> Result<PageHandle, BrowserError>

pub fn create_worker( &self, page: &PageHandle, script: &str, ) -> Result<WorkerHandle, BrowserError>

Create a Dedicated Worker bridged to a page’s servo Realm.

This is the primary entry point for the Worker constructor bridging Create a Dedicated Worker via servo’s native Worker::Constructor.

Per DEC-WK-001 (BCE-20260627-008), bao no longer spawns a bao_engine::WebWorker bypass thread. Instead, this method dispatches new Worker(url) into the page via servo’s DOM binding, and servo constructs the Worker thread + DedicatedWorkerGlobalScope internally. bao’s role is reduced to:

1. Steering stealth profile + DedicatedWorkerGlobalScope Web APIs by registering the scope callback via register_worker_scope_callback_native (invoked at page-init time, see inject_all_with_profile). The callback runs on the Worker thread via the servo vendor patch drain_worker_scope_callbacks.
2. Tracking the WorkerHandle for CDP observability + page-unload termination (criterion #10, AutoCloseWorker).
3. Providing a WorkerChannelBridge for page↔worker postMessage (criterion #6, DF-WK-4/5) so the bao side can still observe structured-clone traffic even though the thread is servo-owned.

The script argument is treated as a Worker script URL. For inline scripts, callers should materialize a data:/blob: URL and pass it here (or call create_worker_with_url).

@trace DEC-WK-001 servo-native Worker path (bypass removed) @trace REQ-BRW-004 [entity:Worker] [criterion:1..10] [criterion:12..18] @trace REQ-BRW-4 [criterion:C1..C4]

pub fn create_worker_with_url( &self, page: &PageHandle, url: &str, ) -> Result<WorkerHandle, BrowserError>

Create a Dedicated Worker with a script URL resolved by servo’s native script loading pipeline.

Per DEC-WK-001 (BCE-20260627-008) the bypass bao_engine::WebWorker path is removed. The Worker is constructed by servo’s DOM Worker::Constructor when new Worker(url) is evaluated in the page. This method:

1. Builds the WorkerId + WorkerHandle (closing/terminated flags + REALM_PROFILES global_addr_slot, criterion #18).
2. Wires up the WorkerChannelBridge (criterion #6, DF-WK-4/5).
3. Registers DedicatedWorkerGlobalScope state for CDP observability (criteria #8, #12-17 stealth consistency).
4. Tracks the Worker with AutoCloseWorker (criterion #10).
5. Dispatches new Worker(url) into the page via servo’s DOM binding.

@trace DEC-WK-001 servo-native Worker path (bypass removed) @trace REQ-BRW-004 [entity:Worker] [DF-WK-2] @trace REQ-BRW-4 [criterion:C1..C4]

pub fn spin_event_loop(&self)

pub fn set_console_log_channel(&self, tx: Sender<ConsoleMessage>)

Set the console log forwarding channel on the servo delegate. Console messages from servo will be sent to this channel.

pub fn set_event_channel(&self, tx: Sender<ServoEvent>)

Set the structured event forwarding channel on the servo delegate. When set, servo callbacks push ServoEvent (Path B) as the primary event path. @trace REQ-CDP-006 [entity:ServoDelegateHooks]

pub fn run(&self) -> Result<(), BrowserError>

pub fn pump_cdp(&self, duration: Duration)

Bounded single-thread CDP pump: spin the servo loop and drain the memory:// CDP bridge for duration. This is the single-threaded consumer contract for in-process CDP — the BaoRuntime is !Send (per-thread JSContext model), so the runtime thread pumps while a helper thread holds the Browser client whose dispatches arrive through the bridge channel this drain answers.

BaoRuntime::run is the unbounded version (it also drains).

pub fn run_with_bridge( &self, bridge_rx: BridgeReceiver, servo_event_rx: Receiver<ServoEvent>, broadcaster: Arc<EventBroadcaster>, ) -> Result<(), BrowserError>

Run with a CDP bridge that processes commands during the event loop. Also drains ServoEvent from the EventSubscriber path (Path B) and broadcasts translated CdpEvents via the shared EventBroadcaster. @trace REQ-CDP-006 [entity:ServoDelegateHooks]

Trait Implementations

impl Drop for BaoRuntime

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.