Struct JsRuntime 

pub struct JsRuntime { /* private fields */ }

A JS engine instance with DOM bindings installed.

Implementations

impl JsRuntime

pub fn new(dom: Rc<DomTree>) -> Self

Creates a runtime sharing the given DOM tree with the browser side.

pub fn set_viewport(&mut self, width: f32, height: f32)

Updates the CSS-pixel viewport exposed through the Window API.

pub fn set_language(&mut self, language: &str)

Updates the language preferences exposed through navigator.

pub fn run_script(&mut self, source: &str)

Evaluates a script, logging JS errors instead of crashing the page.

pub fn eval_value(&mut self, source: &str) -> JSValue

Evaluates an expression and returns its value, or undefined on error.

pub fn set_document_url(&mut self, url: &str)

Updates the URL exposed through the window’s location object.

pub fn set_page_origin(&mut self, origin: &str)

Updates the serialized origin exposed through the window’s location/window/document objects.

pub fn dispatch_dom_content_loaded(&mut self) -> bool

Dispatches DOMContentLoaded to document listeners once.

Returns true only for the first dispatch attempt. Listener errors are logged and do not prevent the remaining listeners from running.

pub fn dispatch_window_load(&mut self) -> bool

Dispatches the window load event once the page has finished loading.

Supports the body onload inline handler, the window.onload property, and addEventListener("load", ...) registrations in that order. Returns true only for the first dispatch attempt.

pub fn run_due_timers(&mut self) -> bool

Runs timer callbacks whose deadlines have elapsed.

Returns whether at least one callback was invoked. Repeating timers are rescheduled before invocation so they can cancel themselves.

pub fn needs_redraw(&self) -> bool

Returns whether a script mutated the DOM and a relayout is needed.

pub fn take_needs_redraw(&self) -> bool

Clears and returns the redraw flag.

pub fn take_iframe_fetch_requests(&mut self) -> Vec<JsIframeFetchRequest>

Takes iframe-loading requests queued by JavaScript since the previous call. Each must be resolved via resolve_iframe_fetch once fetched.

pub fn resolve_iframe_fetch(&mut self, dom_id: u64, html: String)

Parses fetched iframe HTML, installs it as the iframe’s contentDocument and fires the iframe’s load event.

pub fn reject_iframe_fetch(&mut self, dom_id: u64)

Marks an iframe load as failed so later contentDocument accesses do not keep re-queuing a fetch.

pub fn snapshot(&self) -> DomSnapshot

Serializes the current mirror DOM for the browser side.

Nodes exposed to scripts keep their stable dom_id so the UI thread can rebuild the tree and re-register references on commit.

pub fn snapshot_iframe_documents(&self) -> Vec<IframeContentSnapshot>

Serializes every iframe’s content document into movable snapshots so the layout can render each <iframe>’s content nested inside the host page.

pub fn apply_dom(&mut self, snapshot: &DomSnapshot)

Replaces the mirror DOM with a snapshot produced by the browser side.

The mirror is rebuilt from snapshot and node references are re-registered so existing JS element handles keep resolving. JS-created (detached) nodes are preserved; they are not part of the committed DOM but may still be referenced from scripts.

pub fn click_dom_id(&mut self, dom_id: u64) -> bool

Dispatches a click to the handlers registered on the element with the given JS-facing dom id. Returns whether at least one handler ran.

pub fn click(&mut self, node: &NodeRef<HtmlNodeType>) -> bool

Dispatches a click to the handlers registered on node.

Both the onclick property and addEventListener("click", ...) are supported. The event bubbles through exposed ancestor elements so delegated listeners such as React’s root listener receive it. Returns whether at least one handler ran.

pub fn scroll_dom_id(&mut self, dom_id: u64) -> bool

Dispatches a scroll event to the handlers registered on the element with the given JS-facing dom id. Returns whether at least one handler ran.

pub fn scroll(&mut self, node: &NodeRef<HtmlNodeType>) -> bool

Dispatches a scroll event that bubbles through node’s exposed ancestors.

Both the onscroll property and addEventListener("scroll", ...) are supported. Returns whether at least one handler ran.