wasm-bindgen-shared

Shared support between wasm-bindgen and wasm-bindgen cli, an internal dependency

24 releases

0.2.21 Sep 7, 2018
0.2.20 Sep 6, 2018
0.2.19 Aug 27, 2018
0.2.15 Jul 26, 2018
0.1.1 Mar 6, 2018

#4 in WebAssembly

Download history 383/week @ 2018-06-15 227/week @ 2018-06-22 395/week @ 2018-06-29 251/week @ 2018-07-06 280/week @ 2018-07-13 604/week @ 2018-07-20 801/week @ 2018-07-27 507/week @ 2018-08-03 781/week @ 2018-08-10 1524/week @ 2018-08-17 1280/week @ 2018-08-24 1278/week @ 2018-08-31 2930/week @ 2018-09-07

3,746 downloads per month
Used in 23 crates (4 directly)

MIT/Apache

7KB
175 lines

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.

Dependencies

~1.5MB
~28K SLoC

  • build build.rs