Struct deno_core::JsRealm

pub struct JsRealm(_);

A representation of a JavaScript realm tied to a JsRuntime, that allows execution in the realm’s context.

A JsRealm instance does not hold ownership of its corresponding realm, so they can be created and dropped as needed. And since every operation on them requires passing a mutable reference to the JsRuntime, multiple JsRealm instances won’t overlap.

Panics

Every method of JsRealm will panic if you call if with a reference to a JsRuntime other than the one that corresponds to the current context.

Lifetime of the realm

A JsRealm instance will keep the underlying V8 context alive even if it would have otherwise been garbage collected.

Implementations

impl JsRealm

pub fn new(context: Global<Context>) -> Self

pub fn context(&self) -> &Global<Context>

pub fn handle_scope<'s>(&self, runtime: &'s mut JsRuntime) -> HandleScope<'s>

pub fn global_object<'s>(&self, runtime: &'s mut JsRuntime) -> Local<'s, Object>

pub fn execute_script(
    &self,
    runtime: &mut JsRuntime,
    name: &str,
    source_code: &str
) -> Result<Global<Value>, Error>

Executes traditional JavaScript code (traditional = not ES modules) in the realm’s context.

name can be a filepath or any other string, eg.

• “/some/file/path.js”
• “”
• “[native code]”

The same name value can be used for multiple executions.

Error 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 RuntimeOptions::js_error_create_fn has been set.

Trait Implementations

impl Clone for JsRealm

fn clone(&self) -> JsRealm

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.