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§
sourcefn resolve(
&self,
specifier: &str,
referrer: &str,
kind: ResolutionKind
) -> Result<ModuleSpecifier, Error>
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.
sourcefn load(
&self,
module_specifier: &ModuleSpecifier,
maybe_referrer: Option<&ModuleSpecifier>,
is_dyn_import: bool,
requested_module_type: RequestedModuleType
) -> ModuleLoadResponse
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§
sourcefn prepare_load(
&self,
_module_specifier: &ModuleSpecifier,
_maybe_referrer: Option<String>,
_is_dyn_import: bool
) -> Pin<Box<dyn Future<Output = Result<(), Error>>>>
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.
sourcefn code_cache_ready(
&self,
_module_specifier: &ModuleSpecifier,
_code_cache: &[u8]
) -> Pin<Box<dyn Future<Output = ()>>>
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.