Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

模块

文件里的 ES 模块

rt.eval_module(text, file) 把 text 当 ES 模块跑。DefaultPlatform 按引用方的文件解析 import(规范化路径,不处理 node_modules)。别的规则(包、URL、虚拟文件系统)就自己写 Platform::load_module。

执行器侧:加载、链接、求值都是同步的;import 绑定实时读导出方的槽;ResolveExport 处理间接导出、export *、歧义; 支持命名空间对象、动态 import()、import.meta。顶层 await 还不支持。

Rust 写的原生模块:#[j8::module]

#[j8::module("myhost:kv", "kv")]
impl Kv {
    fn get(key: &str) -> Option<String> { /* … */ }
}

j8::runtime! { pub MyHost { modules: [Kv], } }

import kv, { get } from "myhost:kv" 经 HostPlatform 工作。序言可以用 __j8_native["myhost:kv"] 拿到同一个对象, 比如用来实现 require。

自定义平台

dune 的 node: 模块是序言建的 JavaScript 对象,不是 Rust 类型。它用自己的平台 NodePlatform(dune/src/node/mod.rs) 把它们供给 import:load_module 返回一小段生成的 ES 模块,从 __j8_native 重新导出一个对象;别的说明符交给里面那层平台。

impl<P: Platform> Platform for NodePlatform<P> {
    fn load_module(&self, referrer: &str, specifier: &str) -> Option<(String, String)> {
        match Builtin::try_from(specifier) {
            // "const m = globalThis.__j8_native.builtin(\"fs\"); export default m; export const readFileSync = m.readFileSync; …"
            Ok(b) => Some((format!("node:{}", b.spec().0), b.source())),
            Err(()) => self.inner.load_module(referrer, specifier),
        }
    }
    fn now(&self) -> Duration { self.inner.now() }
    fn wall_clock(&self) -> Duration { self.inner.wall_clock() }
    fn print(&self, line: &str) { self.inner.print(line); }
}

impl<P: Pool> Pool for NodePlatform<P> {               // Platform 要求 Pool:也转发
    fn threads(&self) -> usize { self.inner.threads() }
    fn run(&self, jobs: Vec<Task<'_>>) { self.inner.run(jobs); }
}

返回值的第一个元素是模块的规范名,模块按它缓存:第二次解析到同一个名字的 import 拿到同一个模块。解析成 None 的说明符让 import 失败,报 Error::Syntax("… Cannot find module '…'")。

CommonJS

j8 本身不知道 CommonJS。dune 的 require、module、node_modules 与 package.json(main / exports / imports)解析 都是序言里的 JavaScript(dune/src/node/loader.js),ESM 侧的裸说明符解析在 dune/src/node/esm.rs。见 dune。