JS 代码片段

在开发要在 Web 上运行的 crate 时，你通常需要在代码中包含一些 JS 代码。虽然 js-sys 和 web-sys 涵盖了许多需求，但它们并非无所不能，因此 wasm-bindgen 支持在 Rust 代码旁边编写 JS 代码，并将它们包含在最终的输出制品中。

要包含本地 JS 文件，请使用 #[wasm_bindgen(module)] 宏

#![allow(unused)]
fn main() {
#[wasm_bindgen(module = "/js/foo.js")]
extern "C" {
    fn add(a: u32, b: u32) -> u32;
}
}

此声明表示 extern 块中包含的所有函数都从文件 /js/foo.js 导入，其中根目录相对于 crate 根目录（Cargo.toml 所在的位置）。

当 wasm-bindgen 执行时，/js/foo.js 文件将被包含在最终的输出中，因此你可以在库中使用 module 注解，而无需担心库的用户！

JS 文件本身必须使用 ES 模块语法编写

export function add(a, b) {
    return a + b;
}

如果你有兴趣，可以在 RFC 6 中找到此功能的完整设计。

使用 inline_js

除了 module = "..." 之外，如果你是一个宏作者，你还可以使用 inline_js 属性

#![allow(unused)]
fn main() {
#[wasm_bindgen(inline_js = "export function add(a, b) { return a + b; }")]
extern "C" {
    fn add(a: u32, b: u32) -> u32;
}
}

使用 inline_js 表示 JS 模块是在属性本身中内联指定的，并且没有从文件系统加载任何文件。它们与使用 module 时具有相同的限制和注意事项，但有时对于宏本身来说更容易生成。不建议手写代码使用 inline_js，而是尽可能利用 module。

注意事项

虽然非常有用，但本地 JS 代码片段目前存在一些注意事项，需要了解。不过，其中许多都是暂时的！

• 目前，JS 文件中不支持 import 语句。这是一种限制，我们可能会在将来解除，一旦我们找到一个好的方法来支持它。不过，现在，js 代码片段必须是独立的模块，不能从其他任何地方导入。

• 仅支持 --target web 和默认的捆绑器输出模式。要支持 --target nodejs，我们需要将 ES 模块语法转换为 CommonJS（这计划要完成，只是还没有完成）。此外，要支持 --target no-modules，我们必须类似地将 ES 模块转换为其他东西。

• module = "..." 中的路径目前必须以 / 开头，或者以 crate 根目录为根目录。它最终将支持像 ./ 和 ../ 这样的相对路径，但目前认为这需要 Rust proc_macro crate 中提供更多支持。

如上所述，可以在 RFC 6 中找到有关注意事项的更多详细信息。