Facilitating high-level interactions between Wasm modules and JavaScript
Go to file
Alex Crichton 9729efe50e Remove casting to &mut T for JS casts
I discussed this with @fitzgen awhile back and this sort of casting seems
especially problematic when you have code along the lines of:

    let mut x: HtmlElement = ...;
    {
        let y: &mut JsValue = x.as_ref();
        *y = 3.into();
    }
    x.some_html_element_method();

as that will immediately throw! We didn't have a use case for mutable casting
other than consistency, so this commit removes it for now. We can possibly add
it back in later if motivated, but for now it seems reasonable to try to avoid
these sorts of pitfalls!
2018-08-24 20:45:11 -07:00
.cargo Don't run the test runner in release mode 2018-08-04 08:22:47 -07:00
crates Remove casting to &mut T for JS casts 2018-08-24 20:45:11 -07:00
examples Fix merge conflicts with fetch example 2018-08-20 11:23:02 -07:00
guide Remove use_extern_macros features 2018-08-19 14:33:01 -07:00
releases Add a template for release announcements 2018-06-19 12:05:52 -07:00
src Remove casting to &mut T for JS casts 2018-08-24 20:45:11 -07:00
tests Merge pull request #741 from alexcrichton/duplicate-statics 2018-08-20 11:37:21 -07:00
.appveyor.yml Enable js-sys, web-sys, and webidl-tests tests in appveyor 2018-08-14 19:12:29 -04: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 Provide no input for yarn 2018-08-20 14:15:42 -07:00
Cargo.toml Merge pull request #729 from eminence/fetch 2018-08-20 10:35:57 -07:00
CHANGELOG.md Bump to 0.2.17 2018-08-16 23:36:42 -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 webpack from 4.17.0 to 4.17.1 2018-08-23 08:12:54 +00:00
package.json Bump webpack from 4.17.0 to 4.17.1 2018-08-23 08:12:54 +00:00
README.md Remove use_extern_macros features 2018-08-19 14:33:01 -07:00
yarn.lock Bump webpack from 4.17.0 to 4.17.1 2018-08-23 08:12:54 +00:00

wasm-bindgen

Facilitating high-level interactions between wasm modules and JavaScript.

Build Status Build status API Documentation on docs.rs

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

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 with ECMAScript modules!

import { greet } from "./hello_world";

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.