wasm-server-runner
| Crates.io | wasm-server-runner |
| lib.rs | wasm-server-runner |
| version | |
| source | src |
| created_at | 2021-12-10 21:16:39.594727+00 |
| updated_at | 2025-03-24 22:35:05.37824+00 |
| description | cargo run for wasm programs |
| homepage | |
| repository | https://github.com/jakobhellermann/wasm-server-runner/ |
| max_upload_size | |
| id | 495884 |
| Cargo.toml error: | TOML parse error at line 17, column 1 | 17 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
Jakob Hellermann (jakobhellermann)
documentation
README
wasm-server-runner
Allows you to run programs in the browser using web assembly using a simple cargo run.
Usage
Step 1.
rustup target add wasm32-unknown-unknown
cargo install wasm-server-runner
Step 2.
Add this to your ~/.cargo/config.toml (not the Cargo.toml of your project!):
[target.wasm32-unknown-unknown]
runner = "wasm-server-runner"
Step 3.
Run programs in the browser using
cargo run --target wasm32-unknown-unknown
cargo run --target wasm32-unknown-unknown --example example
wasm-server-runner path/to/file.wasm
Example output:
INFO wasm_server_runner: wasm output is 49.79kb large
INFO wasm_server_runner: starting webserver at http://127.0.0.1:1334
The website will reload when the server is restarted and serve files relative to the current directory.
Configuration options
All configuration options can be specified via environment variables.
WASM_SERVER_RUNNER_ADDRESS
Default: 127.0.0.1
Control the address that the server listens on. Set to 0.0.0.0 to allow access from anywhere.
WASM_SERVER_RUNNER_DIRECTORY
Default: .
Can be used to specify where relative path requests are loaded from.
WASM_SERVER_RUNNER_CUSTOM_INDEX_HTML
Default: none
When set, will try to load the custom index.html from that path instead of the
default. Can be relative to the directory.
Note: To support both module and non-module style the index.html needs to have specific string that will be replaced at runtime. The body should contain something like
{{ NO_MODULE }}
<script type="module">
// {{ MODULE }}
</script>
WASM_SERVER_RUNNER_HTTPS
Default: false
Controls whether https is used.
WASM_SERVER_RUNNER_NO_MODULE
Default: false
Controls whether the wasm-bindgen output uses modules or not.