Struct deno_core::EsIsolate

pub struct EsIsolate(_);

More specialized version of CoreIsolate that provides loading and execution of ES Modules.

Creating EsIsolate requires to pass loader argument that implements ModuleLoader trait - that way actual resolution and loading of modules can be customized by the implementor.

Implementations

impl EsIsolate

pub fn new(
    loader: Rc<dyn ModuleLoader>,
    startup_data: StartupData<'_>,
    will_snapshot: bool
) -> Self

pub fn mod_evaluate(&mut self, id: ModuleId) -> Result<(), ErrBox>

Evaluates an already instantiated ES module.

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 async fn load_module<'_, '_>(
    &'_ mut self,
    specifier: &'_ ModuleSpecifier,
    code: Option<String>
) -> Result<ModuleId, ErrBox>

Asynchronously load specified module and all of it's dependencies

User must call Isolate::mod_evaluate with returned ModuleId manually after load is finished.

pub fn snapshot(&mut self) -> StartupData

pub fn state(isolate: &Isolate) -> Rc<RefCell<EsIsolateState>>

Methods from Deref<Target = CoreIsolate>

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.

pub fn register_op<F>(&mut self, name: &str, op: F) -> OpId where
    F: Fn(&mut CoreIsolateState, &mut [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 register_op_json_sync<F>(&mut self, name: &str, op: F) -> OpId where
    F: 'static + Fn(&mut CoreIsolateState, Value, &mut [ZeroCopyBuf]) -> Result<Value, ErrBox>, 

pub fn register_op_json_async<F, Fut>(&mut self, name: &str, op: F) -> OpId where
    Fut: 'static + Future<Output = Result<Value, ErrBox>>,
    F: 'static + Fn(&mut CoreIsolateState, Value, &mut [ZeroCopyBuf]) -> Fut, 

pub fn add_near_heap_limit_callback<C>(&mut self, cb: C) where
    C: FnMut(usize, usize) -> usize + 'static, 

Registers a callback on the isolate when the memory limits are approached. Use this to prevent V8 from crashing the process when reaching the limit.

Calls the closure with the current heap limit and the initial heap limit. The return value of the closure is set as the new limit.

pub fn remove_near_heap_limit_callback(&mut self, heap_limit: usize)

Trait Implementations

impl Deref for EsIsolate

type Target = CoreIsolate

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for EsIsolate

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Future for EsIsolate

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.