这是一个很好的问题,而且也有一些细微差别!值得呼吁的是闭包示例 in the wasm-bindgen
指南(以及关于将闭包传递给 JavaScript 的部分),如果有必要的话,最好也能做出贡献!
不过,为了让您开始,您可以执行以下操作:
use wasm_bindgen::{Closure, JsValue};
#[wasm_bindgen]
pub fn start_game(
start_time: f64,
screen_width: f32,
screen_height: f32,
on_render: &js_sys::Function,
on_collision: &js_sys::Function,
) -> JsValue {
let cb = Closure::wrap(Box::new(move |time| {
time * 4.2
}) as Box<FnMut(f64) -> f64>);
// Extract the `JsValue` from this `Closure`, the handle
// on a JS function representing the closure
let ret = cb.as_ref().clone();
// Once `cb` is dropped it'll "neuter" the closure and
// cause invocations to throw a JS exception. Memory
// management here will come later, so just leak it
// for now.
cb.forget();
return ret;
}
返回值上面只是一个普通的 JS 对象(这里作为JsValue
),我们用Closure
您已经见过的类型。这将允许您快速将闭包返回给 JS,并且您也可以从 JS 调用它。
您还询问过如何存储可变对象等,这都可以通过普通的 Rust 闭包、捕获等来完成。例如FnMut(f64) -> f64
上面是 JS 函数的签名,它可以是任何类型的集合,例如FnMut(String, MyCustomWasmBindgenType, f64) ->
Vec<u8>
如果你真的想要的话。要捕获本地对象,您可以执行以下操作:
let mut camera = Camera::new();
let mut state = State::new();
let cb = Closure::wrap(Box::new(move |arg1, arg2| { // note the `move`
if arg1 {
camera.update(&arg2);
} else {
state.update(&arg2);
}
}) as Box<_>);
(或类似的东西)
这里的camera
and state
变量将由闭包拥有并同时被删除。有关仅关闭的更多信息可以在 Rust 书中找到.
这里还值得简要介绍一下内存管理方面。在里面
上面的例子我们正在调用forget()
它会泄漏内存,如果多次调用 Rust 函数,这可能会成为一个问题(因为它会泄漏大量内存)。这里的根本问题是在创建的 JS 函数对象引用的 WASM 堆上分配了内存。理论上,每当 JS 函数对象被 GC 时,就需要释放分配的内存,但我们无法知道这种情况何时发生(直到WeakRef exists!).
与此同时,我们选择了替代策略。相关的内存是
每当Closure
类型本身被删除,提供
确定性破坏。然而,这使得工作变得困难,因为我们需要手动确定何时删除Closure
. If forget
不适合您的用例,一些放弃的想法Closure
are:
首先,如果它是一个仅调用一次的 JS 闭包,那么您可以使用Rc
/RefCell
删除Closure
在闭合本身内部(使用一些内部
可变性恶作剧)。我们也应该最终
提供原生支持
为了FnOnce
in wasm-bindgen
还有!
接下来,您可以向 Rust 返回一个辅助 JS 对象,该对象有一个手册free
方法。例如一个#[wasm_bindgen]
- 带注释的包装器。这个包装器将
然后需要在合适的时候在JS中手动释放。
如果你能熬过来的话forget
是迄今为止最容易做的事情
现在看来,但这绝对是一个痛点!我们等不及了WeakRef
存在 :)