Struct deno_runtime::worker::MainWorker

pub struct MainWorker {
    pub js_runtime: JsRuntime,
    /* private fields */
}

This worker is created and used by almost all subcommands in Deno executable.

It provides ops available in the Deno namespace.

All WebWorkers created during program execution are descendants of this worker.

Fields

js_runtime: JsRuntime

Implementations

impl MainWorker

pub fn bootstrap_from_options( main_module: ModuleSpecifier, permissions: PermissionsContainer, options: WorkerOptions ) -> Self

Examples found in repository

examples/hello_runtime.rs (lines 23-31)

async fn main() -> Result<(), AnyError> {
  let js_path =
    Path::new(env!("CARGO_MANIFEST_DIR")).join("examples/hello_runtime.js");
  let main_module = ModuleSpecifier::from_file_path(js_path).unwrap();
  let mut worker = MainWorker::bootstrap_from_options(
    main_module.clone(),
    PermissionsContainer::allow_all(),
    WorkerOptions {
      module_loader: Rc::new(FsModuleLoader),
      extensions: vec![hello_runtime::init_ops_and_esm()],
      ..Default::default()
    },
  );
  worker.execute_main_module(&main_module).await?;
  worker.run_event_loop(false).await?;
  Ok(())
}

pub fn from_options( main_module: ModuleSpecifier, permissions: PermissionsContainer, options: WorkerOptions ) -> Self

pub fn bootstrap(&mut self, options: &BootstrapOptions)

pub fn execute_script( &mut self, script_name: &'static str, source_code: ModuleCode ) -> Result<Global<Value>, AnyError>

See JsRuntime::execute_script

pub async fn preload_main_module( &mut self, module_specifier: &ModuleSpecifier ) -> Result<ModuleId, AnyError>

Loads and instantiates specified JavaScript module as “main” module.

pub async fn preload_side_module( &mut self, module_specifier: &ModuleSpecifier ) -> Result<ModuleId, AnyError>

Loads and instantiates specified JavaScript module as “side” module.

pub async fn evaluate_module(&mut self, id: ModuleId) -> Result<(), AnyError>

Executes specified JavaScript module.

pub async fn execute_side_module( &mut self, module_specifier: &ModuleSpecifier ) -> Result<(), AnyError>

Loads, instantiates and executes specified JavaScript module.

pub async fn execute_main_module( &mut self, module_specifier: &ModuleSpecifier ) -> Result<(), AnyError>

Loads, instantiates and executes specified JavaScript module.

This module will have “import.meta.main” equal to true.

Examples found in repository

examples/hello_runtime.rs (line 32)

async fn main() -> Result<(), AnyError> {
  let js_path =
    Path::new(env!("CARGO_MANIFEST_DIR")).join("examples/hello_runtime.js");
  let main_module = ModuleSpecifier::from_file_path(js_path).unwrap();
  let mut worker = MainWorker::bootstrap_from_options(
    main_module.clone(),
    PermissionsContainer::allow_all(),
    WorkerOptions {
      module_loader: Rc::new(FsModuleLoader),
      extensions: vec![hello_runtime::init_ops_and_esm()],
      ..Default::default()
    },
  );
  worker.execute_main_module(&main_module).await?;
  worker.run_event_loop(false).await?;
  Ok(())
}

pub async fn create_inspector_session(&mut self) -> LocalInspectorSession

Create new inspector session. This function panics if Worker was not configured to create inspector.

pub fn poll_event_loop( &mut self, cx: &mut Context<'_>, wait_for_inspector: bool ) -> Poll<Result<(), AnyError>>

pub async fn run_event_loop( &mut self, wait_for_inspector: bool ) -> Result<(), AnyError>

Examples found in repository

examples/hello_runtime.rs (line 33)

async fn main() -> Result<(), AnyError> {
  let js_path =
    Path::new(env!("CARGO_MANIFEST_DIR")).join("examples/hello_runtime.js");
  let main_module = ModuleSpecifier::from_file_path(js_path).unwrap();
  let mut worker = MainWorker::bootstrap_from_options(
    main_module.clone(),
    PermissionsContainer::allow_all(),
    WorkerOptions {
      module_loader: Rc::new(FsModuleLoader),
      extensions: vec![hello_runtime::init_ops_and_esm()],
      ..Default::default()
    },
  );
  worker.execute_main_module(&main_module).await?;
  worker.run_event_loop(false).await?;
  Ok(())
}

pub async fn with_event_loop<'a, T>( &mut self, fut: Pin<Box<dyn Future<Output = T> + 'a>> ) -> T

A utility function that runs provided future concurrently with the event loop.

Useful when using a local inspector session.

pub fn exit_code(&self) -> i32

Return exit code set by the executed code (either in main worker or one of child web workers).

pub fn dispatch_load_event( &mut self, script_name: &'static str ) -> Result<(), AnyError>

Dispatches “load” event to the JavaScript runtime.

Does not poll event loop, and thus not await any of the “load” event handlers.

pub fn dispatch_unload_event( &mut self, script_name: &'static str ) -> Result<(), AnyError>

Dispatches “unload” event to the JavaScript runtime.

Does not poll event loop, and thus not await any of the “unload” event handlers.

pub fn dispatch_beforeunload_event( &mut self, script_name: &'static str ) -> Result<bool, AnyError>

Dispatches “beforeunload” event to the JavaScript runtime. Returns a boolean indicating if the event was prevented and thus event loop should continue running.