Trait deno_core::ModuleLoader

source · 
pub trait ModuleLoader {
    // Required methods
    fn resolve(
        &self,
        specifier: &str,
        referrer: &str,
        kind: ResolutionKind
    ) -> Result<ModuleSpecifier, Error>;
    fn load(
        &self,
        module_specifier: &ModuleSpecifier,
        maybe_referrer: Option<&ModuleSpecifier>,
        is_dyn_import: bool,
        requested_module_type: RequestedModuleType
    ) -> ModuleLoadResponse;

    // Provided methods
    fn prepare_load(
        &self,
        _module_specifier: &ModuleSpecifier,
        _maybe_referrer: Option<String>,
        _is_dyn_import: bool
    ) -> Pin<Box<dyn Future<Output = Result<(), Error>>>> { ... }
    fn code_cache_ready(
        &self,
        _module_specifier: &ModuleSpecifier,
        _code_cache: &[u8]
    ) -> Pin<Box<dyn Future<Output = ()>>> { ... }
}

Required Methods§

source

fn resolve( &self, specifier: &str, referrer: &str, kind: ResolutionKind ) -> Result<ModuleSpecifier, Error>

Returns an absolute URL. When implementing an spec-complaint VM, this should be exactly the algorithm described here: https://html.spec.whatwg.org/multipage/webappapis.html#resolve-a-module-specifier

ResolutionKind::MainModule can be used to resolve from current working directory or apply import map for child imports.

ResolutionKind::DynamicImport can be used to check permissions or deny dynamic imports altogether.

source

fn load( &self, module_specifier: &ModuleSpecifier, maybe_referrer: Option<&ModuleSpecifier>, is_dyn_import: bool, requested_module_type: RequestedModuleType ) -> ModuleLoadResponse

Given ModuleSpecifier, load its source code.

is_dyn_import can be used to check permissions or deny dynamic imports altogether.

Provided Methods§

source

fn prepare_load( &self, _module_specifier: &ModuleSpecifier, _maybe_referrer: Option<String>, _is_dyn_import: bool ) -> Pin<Box<dyn Future<Output = Result<(), Error>>>>

This hook can be used by implementors to do some preparation work before starting loading of modules.

For example implementor might download multiple modules in parallel and transpile them to final JS sources before yielding control back to the runtime.

It’s not required to implement this method.

source

fn code_cache_ready( &self, _module_specifier: &ModuleSpecifier, _code_cache: &[u8] ) -> Pin<Box<dyn Future<Output = ()>>>

Called when new v8 code cache is available for this module. Implementors can store the provided code cache for future executions of the same module.

It’s not required to implement this method.

Implementors§