README
Tr
JsRuntime
E
JsError
- ::execution_errorJsError::execution_error
T
AsyncExecutionMode
T
JsContext
- ::clear_logsJsContext::clear_logs
- ::executeJsContext::execute
- ::get_domJsContext::get_dom
- ::get_logsJsContext::get_logs
- ::newJsContext::new
- ::new_deferredJsContext::new_deferred
- ::new_with_runtimeJsContext::new_with_runtime
- ::new_with_runtime_and_modeJsContext::new_with_runtime_and_mode
- ::tickJsContext::tick
T
JsResult
- ::newJsResult::new
T
ScriptExecutor
- ::clear_logsScriptExecutor::clear_logs
- ::executeScriptExecutor::execute
- ::execute_sourceScriptExecutor::execute_source
- ::get_logsScriptExecutor::get_logs
- ::newScriptExecutor::new
- ::new_deferredScriptExecutor::new_deferred
- ::new_with_runtimeScriptExecutor::new_with_runtime
- ::tickScriptExecutor::tick
V
create_dom_init_code
V
enqueue_script
V
enqueue_script_after
V
execute_script_task
V
init_js_runtime
V
process_script_tasks
V
serialize_dom_for_mock
V
serialize_dom_to_html
V
serialize_dom_to_snapshot_html

crater-browser-runtime

Shared browser JS runtime contract and DOM serializer for crater

moon add mizchi/crater-browser-runtime@0.19.0

Download zip

Author

mizchi

Version

0.19.0

License

Apache-2.0

Repository

github.com/mizchi/crater

Last updated

last month

Downloads

261

Dependencies

mizchi/crater-dom0.19.0

README

mizchi/crater-browser-runtime does not have a README file

#
JsRuntime

source

pub(open) trait JsRuntime {
  fn init(Self) -> Unit
  fn execute(Self, Int, @mizchi/crater-dom/dom.DomTree
DomTree, String, AsyncExecutionMode) -> JsResult raise JsError
  fn tick(Self, Int, @mizchi/crater-dom/dom.DomTree
DomTree) -> JsResult raise JsError
}

JavaScript runtime abstraction

#
JsError

source

pub suberror JsError {
  NotSupported
  ExecutionError(String)
  SyntaxError(String)
  ReferenceError(String)
}

Error types for JS execution Note: Some variants are reserved for future use

impl Show for JsError

#
JsError::execution_error

source

fn JsError::execution_error(msg : String) -> JsError

Create an ExecutionError (for use by external JsRuntime implementations).

#
AsyncExecutionMode

source

pub(all) enum AsyncExecutionMode {
  ImmediateFlush
  DeferredFlush
}

#
JsContext

source

pub struct JsContext {
  context_id : Int
  async_mode : AsyncExecutionMode
  dom : @mizchi/crater-dom/dom.DomTree
DomTree
  logs : Array[String]
  runtime : &JsRuntime
}

JavaScript execution context bound to a DomTree

#
JsContext::clear_logs

source

fn JsContext::clear_logs(self : JsContext) -> Unit

Clear console logs

#
JsContext::execute

source

fn JsContext::execute(self : JsContext, code : String) -> JsResult raise JsError

Execute JavaScript code with runtime abstraction

#
JsContext::get_dom

source

fn JsContext::get_dom(self : JsContext) -> @mizchi/crater-dom/dom.DomTree
DomTree

Get the DOM tree from context

#
JsContext::get_logs

source

fn JsContext::get_logs(self : JsContext) -> Array[String]

Get captured console logs

#
JsContext::new

source

fn JsContext::new(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> JsContext

Create a new JS execution context with a DOM tree

#
JsContext::new_deferred

source

fn JsContext::new_deferred(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> JsContext

#
JsContext::new_with_runtime

source

fn JsContext::new_with_runtime(dom : @mizchi/crater-dom/dom.DomTree
DomTree, runtime : &JsRuntime) -> JsContext

Create a new JS execution context with explicit runtime

#
JsContext::new_with_runtime_and_mode

source

fn JsContext::new_with_runtime_and_mode(dom : @mizchi/crater-dom/dom.DomTree
DomTree, runtime : &JsRuntime, async_mode : AsyncExecutionMode) -> JsContext

#
JsContext::tick

source

fn JsContext::tick(self : JsContext) -> Bool raise JsError

#
JsResult

source

pub struct JsResult {
  value : String
  logs : Array[String]
  success : Bool
}

Result of JS execution

#
JsResult::new

source

fn JsResult::new(value : String, logs : Array[String], success : Bool) -> JsResult

Create a new JS result value

#
ScriptExecutor

source

pub struct ScriptExecutor {
  dom : @mizchi/crater-dom/dom.DomTree
DomTree
  ctx : JsContext
}

Script executor that runs in the scheduler event loop

#
ScriptExecutor::clear_logs

source

fn ScriptExecutor::clear_logs(self : ScriptExecutor) -> Unit

Clear accumulated logs

#
ScriptExecutor::execute

source

fn ScriptExecutor::execute(self : ScriptExecutor, task : @mizchi/crater-dom/scheduler.Task
Task) -> @mizchi/crater-dom/scheduler.TaskResult
TaskResult

Execute a script task using ScriptExecutor

#
ScriptExecutor::execute_source

source

fn ScriptExecutor::execute_source(self : ScriptExecutor, source : String) -> JsResult raise JsError

Execute inline JavaScript source immediately against the current DOM.

#
ScriptExecutor::get_logs

source

fn ScriptExecutor::get_logs(self : ScriptExecutor) -> Array[String]

Get accumulated logs from the JS context

#
ScriptExecutor::new

source

fn ScriptExecutor::new(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> ScriptExecutor

Create a new script executor

#
ScriptExecutor::new_deferred

source

fn ScriptExecutor::new_deferred(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> ScriptExecutor

#
ScriptExecutor::new_with_runtime

source

fn ScriptExecutor::new_with_runtime(dom : @mizchi/crater-dom/dom.DomTree
DomTree, runtime : &JsRuntime) -> ScriptExecutor

Create a script executor with explicit JS runtime implementation.

#
ScriptExecutor::tick

source

fn ScriptExecutor::tick(self : ScriptExecutor) -> Bool raise JsError

#
create_dom_init_code

source

fn create_dom_init_code(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> String

Create initialization code that populates mock DOM from DomTree This builds the HTML structure (html, head, body) with actual content

#
enqueue_script

source

fn enqueue_script(scheduler : @mizchi/crater-dom/scheduler.Scheduler
Scheduler, source : String, blocking : Bool) -> @mizchi/crater-dom/scheduler.TaskId
TaskId

Enqueue a script for execution

#
enqueue_script_after

source

fn enqueue_script_after(scheduler : @mizchi/crater-dom/scheduler.Scheduler
Scheduler, source : String, dependencies : Array[@mizchi/crater-dom/scheduler.TaskId
TaskId], blocking : Bool) -> @mizchi/crater-dom/scheduler.TaskId
TaskId

Enqueue a script with dependencies

#
execute_script_task

source

fn execute_script_task(task : @mizchi/crater-dom/scheduler.Task
Task, dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> @mizchi/crater-dom/scheduler.TaskResult
TaskResult

Execute a script task and return the result for scheduler

#
init_js_runtime

source

fn init_js_runtime() -> Unit

#
process_script_tasks

source

fn process_script_tasks(scheduler : @mizchi/crater-dom/scheduler.Scheduler
Scheduler, dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> Int

Process script tasks from scheduler

#
serialize_dom_for_mock

source

fn serialize_dom_for_mock(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> String

Serialize DomTree to JavaScript object creation code Returns JS code that reconstructs the DOM tree in the mock DOM

#
serialize_dom_to_html

source

fn serialize_dom_to_html(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> String

Serialize DomTree to HTML string for renderer reparse

#
serialize_dom_to_snapshot_html

source

fn serialize_dom_to_snapshot_html(dom : @mizchi/crater-dom/dom.DomTree
DomTree) -> String

Source Files

Site source Report issue Packages Build queue Skills Statistics

crater-browser-runtime

#JsRuntime

#JsError

#JsError::execution_error

#AsyncExecutionMode

#JsContext

#JsContext::clear_logs

#JsContext::execute

#JsContext::get_dom

#JsContext::get_logs

#JsContext::new

#JsContext::new_deferred

#JsContext::new_with_runtime

#JsContext::new_with_runtime_and_mode

#JsContext::tick

#JsResult

#JsResult::new

#ScriptExecutor

#ScriptExecutor::clear_logs

#ScriptExecutor::execute

#ScriptExecutor::execute_source

#ScriptExecutor::get_logs

#ScriptExecutor::new

#ScriptExecutor::new_deferred

#ScriptExecutor::new_with_runtime

#ScriptExecutor::tick

#create_dom_init_code

#enqueue_script

#enqueue_script_after

#execute_script_task

#init_js_runtime

#process_script_tasks

#serialize_dom_for_mock

#serialize_dom_to_html

#serialize_dom_to_snapshot_html

Source Files

#
JsRuntime

#
JsError

#
JsError::execution_error

#
AsyncExecutionMode

#
JsContext

#
JsContext::clear_logs

#
JsContext::execute

#
JsContext::get_dom

#
JsContext::get_logs

#
JsContext::new

#
JsContext::new_deferred

#
JsContext::new_with_runtime

#
JsContext::new_with_runtime_and_mode

#
JsContext::tick

#
JsResult

#
JsResult::new

#
ScriptExecutor

#
ScriptExecutor::clear_logs

#
ScriptExecutor::execute

#
ScriptExecutor::execute_source

#
ScriptExecutor::get_logs

#
ScriptExecutor::new

#
ScriptExecutor::new_deferred

#
ScriptExecutor::new_with_runtime

#
ScriptExecutor::tick

#
create_dom_init_code

#
enqueue_script

#
enqueue_script_after

#
execute_script_task

#
init_js_runtime

#
process_script_tasks

#
serialize_dom_for_mock

#
serialize_dom_to_html

#
serialize_dom_to_snapshot_html