Facilitating high-level interactions between Wasm modules and JavaScript
Go to file
Alex Crichton f3942229fe More reuse of a parity_wasm::Module in the test runner
This commit updates the test runner to only deserialize a `Module` once and then
directly pass it to the `wasm-bindgen` config, avoiding pulling in a public
dependency with the same strategy as the `wasm-gc-api` crate for now.

This reduces the runtime of this step for `wasm-bindgen-test-runner` from ~0.23s
to ~0.19s on my machine.
2018-07-25 15:49:50 -07:00
.cargo Merge the cli and test-runner packages 2018-07-20 22:42:36 -07:00
crates More reuse of a parity_wasm::Module in the test runner 2018-07-25 15:49:50 -07:00
examples Js sys once over (#550) 2018-07-25 16:33:44 -05:00
guide Remove usage of wasm_import_module feature 2018-07-21 19:00:40 -07:00
releases Add a template for release announcements 2018-06-19 12:05:52 -07:00
src Fix a typo in Closure<FnMut(...)> 2018-07-23 17:51:49 -07:00
tests/all Remove usage of wasm_import_module feature 2018-07-21 19:00:40 -07:00
.appveyor.yml use npm ci in ci (#481) 2018-07-14 22:45:58 -05:00
.eslintignore Applied eslint from main .eslintrc to examples (#418) 2018-07-08 01:02:10 -05:00
.eslintrc Create the web-sys crate mechanically from WebIDL (#409) 2018-07-09 16:35:25 -07:00
.gitattributes add .gitattributes to mark WebIDL as vendored 2018-07-11 18:48:51 -04:00
.gitignore Binding for Math.cos,cosh,exp,expml,fround,imul,log,log10,log1p,log2 2018-06-28 12:46:53 -04:00
.travis.yml Merge the cli and test-runner packages 2018-07-20 22:42:36 -07:00
Cargo.toml chore: Sort workspace members 2018-07-25 13:44:14 -07:00
CHANGELOG.md Bump to 0.2.14 2018-07-25 09:46:45 -07:00
CONTRIBUTING.md Point to the guide's contributing section instead of CONTRIBUTING.md 2018-06-19 12:05:52 -07:00
LICENSE-APACHE Add license texts 2017-12-18 14:45:06 -08:00
LICENSE-MIT Add license texts 2017-12-18 14:45:06 -08:00
package-lock.json Bump @types/node from 10.5.2 to 10.5.3 2018-07-25 08:38:04 +00:00
package.json Bump @types/node from 10.5.2 to 10.5.3 2018-07-25 08:38:04 +00:00
README.md Remove usage of wasm_import_module feature 2018-07-21 19:00:40 -07:00
yarn.lock Bump @types/node from 10.5.2 to 10.5.3 2018-07-25 08:38:04 +00:00

wasm-bindgen

Facilitating high-level interactions between wasm modules and JavaScript.

Introduction blog post: "JavaScript to Rust and Back Again: A wasm-bindgen Tale"

Build Status Build status API Documentation on docs.rs

Import JavaScript things into Rust and export Rust things to JavaScript.

src/lib.rs:

#![feature(use_extern_macros)]

extern crate wasm_bindgen;
use wasm_bindgen::prelude::*;

// Import the `window.alert` function from the Web.
#[wasm_bindgen]
extern {
    fn alert(s: &str);
}

// Export a `greet` function from Rust to JavaScript, that alerts a
// hello message.
#[wasm_bindgen]
pub fn greet(name: &str) {
    alert(&format!("Hello, {}!", name));
}

Use exported Rust things from JavaScript!

index.js:

// Asynchronously load, compile, and import the Rust's WebAssembly
// and JavaScript interface.
import("./hello_world").then(module => {
  // Alert "Hello, World!"
  module.greet("World!");
});

Guide

📚 Read the wasm-bindgen guide here! 📚

License

This project is licensed under either of

at your option.

Contribution

See the "Contributing" section of the guide for information on hacking on wasm-bindgen!

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.