mrdziuban / rust-emscripten-loader

Webpack loader for Rust + Emscripten

Rust Webpack loader

Usage

This is a simple Webpack loader that shells out to cargo to build a Rust project targeting either asm.js or WebAssembly. See this post for more details on using Rust to target the web.

To use it, first install the package:

$ npm install --save rust-emscripten-loader

then configure the loader in your Webpack config:

module.exports = {
  // ...
  module: {
    rules: [
      { test: /\.rs$/, loader: 'rust-emscripten-loader' },
      // ...
    ]
  }
}

Make sure you have the cargo, rustc, and emsdk binaries somewhere in your PATH.

When targeting WebAssembly, the loader will emit two additional files: one .wasm and one .js. You must specify the outName option to tell the loader how to name these files, and you'll need to load them info your HTML page in order to run the code. Check out the configuration and example sections below for more details.

Configuration

The following options can be added to the Webpack loader query:

Name	Description	Required	Default
release	Whether or not to pass the --release flag to cargo	false	false
target	The output target of the cargo build. Available options are asmjs and wasm.	false	asmjs
outName	The name of the output file for the wasm and js files when targeting wasm	Only when target is wasm	none

Example

Check out the example directory for a simple Hello World example targeting both asm.js and WebAssembly.