Struct deno_core::CoreIsolate

pub struct CoreIsolate {
    pub v8_isolate: Option<OwnedIsolate>,
    pub resource_table: Rc<RefCell<ResourceTable>>,
    pub global_context: Global<Context>,
    pub op_registry: OpRegistry,
    // some fields omitted
}

A single execution context of JavaScript. Corresponds roughly to the "Web Worker" concept in the DOM. An CoreIsolate is a Future that can be used with Tokio. The CoreIsolate future completes when there is an error or when all pending ops have completed.

Ops are created in JavaScript by calling Deno.core.dispatch(), and in Rust by implementing dispatcher function that takes control buffer and optional zero copy buffer as arguments. An async Op corresponds exactly to a Promise in JavaScript.

Fields

v8_isolate: Option<OwnedIsolate>

resource_table: Rc<RefCell<ResourceTable>>

global_context: Global<Context>

op_registry: OpRegistry

Implementations

impl CoreIsolate

pub fn new(startup_data: StartupData, will_snapshot: bool) -> Box<Self>

startup_data defines the snapshot or script used at startup to initialize the isolate.

pub fn register_op<F>(&mut self, name: &str, op: F) -> OpId where
    F: Fn(&mut CoreIsolate, &[u8], Option<ZeroCopyBuf>) -> Op + 'static, 

Defines the how Deno.core.dispatch() acts. Called whenever Deno.core.dispatch() is called in JavaScript. zero_copy_buf corresponds to the second argument of Deno.core.dispatch().

Requires runtime to explicitly ask for op ids before using any of the ops.

pub fn set_js_error_create_fn(
    &mut self,
    f: impl Fn(JSError) -> ErrBox + 'static
)

Allows a callback to be set whenever a V8 exception is made. This allows the caller to wrap the JSError into an error. By default this callback is set to JSError::create.

pub fn dispatch_op<'s>(
    &mut self,
    scope: &mut impl ToLocal<'s>,
    op_id: OpId,
    control_buf: &[u8],
    zero_copy_buf: Option<ZeroCopyBuf>
) -> Option<(OpId, Box<[u8]>)>

pub fn execute(
    &mut self,
    js_filename: &str,
    js_source: &str
) -> Result<(), ErrBox>

Executes traditional JavaScript code (traditional = not ES modules)

ErrBox can be downcast to a type that exposes additional information about the V8 exception. By default this type is JSError, however it may be a different type if CoreIsolate::set_js_error_create_fn() has been used.

pub fn snapshot(&mut self) -> StartupData

Takes a snapshot. The isolate should have been created with will_snapshot set to true.

ErrBox can be downcast to a type that exposes additional information about the V8 exception. By default this type is JSError, however it may be a different type if CoreIsolate::set_js_error_create_fn() has been used.

Trait Implementations

impl Drop for CoreIsolate

fn drop(&mut self)

Executes the destructor for this type.

impl Future for CoreIsolate

type Output = Result<(), ErrBox>

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Self::Output>

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.