constructor
When attached to a Rust "constructor" it will make the generated JavaScript
bindings callable as new Foo()
.
For example, consider this exported Rust type and constructor
annotation:
# #![allow(unused_variables)] #fn main() { #[wasm_bindgen] pub struct Foo { contents: u32, } #[wasm_bindgen] impl Foo { #[wasm_bindgen(constructor)] pub fn new() -> Foo { Foo { contents: 0 } } pub fn get_contents(&self) -> u32 { self.contents } } #}
This can be used in JavaScript as:
import { Foo } from './my_module';
const f = new Foo();
console.log(f.get_contents());
Caveats
In versions >=v0.2.48, <0.2.88
of wasm-bindgen
, there is a bug which breaks inheritance of exported Rust structs from JavaScript side (see #3213). If you want to inherit from a Rust struct such as:
# #![allow(unused_variables)] #fn main() { use wasm_bindgen::prelude::*; #[wasm_bindgen] pub struct Parent { msg: String, } #[wasm_bindgen] impl Parent { #[wasm_bindgen(constructor)] fn new() -> Self { Parent { msg: String::from("Hello from Parent!"), } } } #}
You will need to reset the prototype of this
back to the Child
class prototype after calling the Parent
's constructor via super
.
import { Parent } from './my_module';
class Child extends Parent {
constructor() {
super();
Object.setPrototypeOf(this, Child.prototype);
}
}
This is no longer required as of v0.2.88.