Struct RuntimeOptions 

pub struct RuntimeOptions {

    pub module_loader: Option<Rc<dyn ModuleLoader>>,
    pub extension_code_cache: Option<Rc<dyn ExtCodeCache>>,
    pub extension_transpiler: Option<Rc<dyn Fn(ModuleName, ModuleCodeString) -> Result<(ModuleCodeString, Option<SourceMapData>), JsErrorBox>>>,
    pub op_metrics_factory_fn: Option<OpMetricsFactoryFn>,
    pub extensions: Vec<Extension>,
    pub startup_snapshot: Option<&'static [u8]>,
    pub skip_op_registration: bool,
    pub create_params: Option<CreateParams>,
    pub v8_platform: Option<SharedRef<Platform>>,
    pub shared_array_buffer_store: Option<SharedArrayBufferStore>,
    pub compiled_wasm_module_store: Option<CompiledWasmModuleStore>,
    pub inspector: bool,
    pub is_main: bool,
    pub validate_import_attributes_cb: Option<ValidateImportAttributesCb>,
    pub wait_for_inspector_disconnect_callback: Option<Box<dyn Fn()>>,
    pub custom_module_evaluation_cb: Option<Box<dyn Fn(&mut PinScope<'_, '_>, Cow<'_, str>, &FastString, ModuleSourceCode) -> Result<CustomModuleEvaluationKind, JsErrorBox>>>,
    pub eval_context_code_cache_cbs: Option<(Box<dyn Fn(&Url, &String) -> Result<SourceCodeCacheInfo, JsErrorBox>>, Box<dyn Fn(Url, u64, &[u8])>)>,
    pub import_assertions_support: ImportAssertionsSupport,
    pub maybe_op_stack_trace_callback: Option<OpStackTraceCallback>,
}

Fields

module_loader: Option<Rc<dyn ModuleLoader>>

Implementation of ModuleLoader which will be called when V8 requests to load ES modules in the main realm.

If not provided runtime will error if code being executed tries to load modules.

extension_code_cache: Option<Rc<dyn ExtCodeCache>>

If specified, enables V8 code cache for extension code.

extension_transpiler: Option<Rc<dyn Fn(ModuleName, ModuleCodeString) -> Result<(ModuleCodeString, Option<SourceMapData>), JsErrorBox>>>

If specified, transpiles extensions before loading.

op_metrics_factory_fn: Option<OpMetricsFactoryFn>

Provide a function that may optionally provide a metrics collector for a given op.

extensions: Vec<Extension>

JsRuntime extensions, not to be confused with ES modules. Only ops registered by extensions will be initialized. If you need to execute JS code from extensions, pass source files in js or esm option on ExtensionBuilder.

If you are creating a runtime from a snapshot take care not to include JavaScript sources in the extensions.

startup_snapshot: Option<&'static [u8]>

V8 snapshot that should be loaded on startup.

For testing, use runtime.snapshot() and then Box::leak to acquire

skip_op_registration: bool

Should op registration be skipped?

create_params: Option<CreateParams>

Isolate creation parameters.

v8_platform: Option<SharedRef<Platform>>

V8 platform instance to use. Used when Deno initializes V8 (which it only does once), otherwise it’s silently dropped.

shared_array_buffer_store: Option<SharedArrayBufferStore>

The store to use for transferring SharedArrayBuffers between isolates. If multiple isolates should have the possibility of sharing SharedArrayBuffers, they should use the same SharedArrayBufferStore. If no SharedArrayBufferStore is specified, SharedArrayBuffer can not be serialized.

compiled_wasm_module_store: Option<CompiledWasmModuleStore>

The store to use for transferring WebAssembly.Module objects between isolates. If multiple isolates should have the possibility of sharing WebAssembly.Module objects, they should use the same CompiledWasmModuleStore. If no CompiledWasmModuleStore is specified, WebAssembly.Module objects cannot be serialized.

inspector: bool

Start inspector instance to allow debuggers to connect.

is_main: bool

Describe if this is the main runtime instance, used by debuggers in some situation - like disconnecting when program finishes running.

validate_import_attributes_cb: Option<ValidateImportAttributesCb>

A callback that can be used to validate import attributes received at the import site. If no callback is provided, all attributes are allowed.

Embedders might use this callback to eg. validate value of “type” attribute, not allowing other types than “JSON”.

To signal validation failure, users should throw an V8 exception inside the callback.

wait_for_inspector_disconnect_callback: Option<Box<dyn Fn()>>

A callback that is called when the event loop has no more work to do, but there are active, non-blocking inspector session (eg. Chrome DevTools inspector is connected). The embedder can use this callback to eg. print a message notifying user about program finished running. This callback can be called multiple times, eg. after the program finishes more work can be scheduled from the DevTools.

custom_module_evaluation_cb: Option<Box<dyn Fn(&mut PinScope<'_, '_>, Cow<'_, str>, &FastString, ModuleSourceCode) -> Result<CustomModuleEvaluationKind, JsErrorBox>>>

A callback that allows to evaluate a custom type of a module - eg. embedders might implement loading WASM or test modules.

eval_context_code_cache_cbs: Option<(Box<dyn Fn(&Url, &String) -> Result<SourceCodeCacheInfo, JsErrorBox>>, Box<dyn Fn(Url, u64, &[u8])>)>

Callbacks to retrieve and store code cache for scripts evaluated through evalContext.

import_assertions_support: ImportAssertionsSupport

maybe_op_stack_trace_callback: Option<OpStackTraceCallback>

A callback to specify how stack traces should be used when an op is annotated with stack_trace attribute. Use wisely, as it’s very expensive to collect stack traces on each op invocation.

Trait Implementations

impl Default for RuntimeOptions

fn default() -> RuntimeOptions

Returns the “default value” for a type.