https://github.com/bytecodealliance/sample-wasi-http-js
An example `wasi:http` server component written in JavaScript
https://github.com/bytecodealliance/sample-wasi-http-js
Last synced: 7 months ago
JSON representation
An example `wasi:http` server component written in JavaScript
- Host: GitHub
- URL: https://github.com/bytecodealliance/sample-wasi-http-js
- Owner: bytecodealliance
- License: apache-2.0
- Created: 2025-04-09T17:27:39.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-05-07T11:29:05.000Z (9 months ago)
- Last Synced: 2025-07-12T00:44:55.740Z (7 months ago)
- Language: JavaScript
- Size: 76.2 KB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-wasm-components - sample-wasi-http-js
README
# Sample: `wasi:http` in JavaScript
[](https://codespaces.new/bytecodealliance/sample-wasi-http-js)
An example project showing how to build a spec-compliant
[`wasi:http/proxy`][wasi-http] server for WASI 0.2 written in JavaScript.
## Routes
The following HTTP routes are available from the component:
```text
/ # Hello world
/sleep # Sleep for {ms} milliseconds
/echo # Echo the HTTP body
/echo-headers # Echo the HTTP headers
/upload # Echo uploaded blob
```
Testing routes:
```bash
# Hello world
$ curl localhost:8080
# Sleep for {ms} milliseconds
$ curl localhost:8080/sleep/2000
# Echo the HTTP body
$ curl -d "Test echo body" localhost:8080/echo
# Echo the HTTP headers
$ curl -H "X-Test-Header: 123" localhost:8080/echo-headers
# Echo uploaded blob
$ echo "Hello World!" > test_file.txt
$ curl -H "Content-Type: text/plain" --data-binary @test_file.txt http://localhost:8080/upload
```
## Quick Start
The project uses [`Wasmtime`][wasmtime] as its runtime. However, if needed, it
can easily be adjusted to use [`jco`][jco] instead. For `wasmtime` installation,
simply run:
```bash
$ curl https://wasmtime.dev/install.sh -sSf | bash
```
The quickest way to start is by using [`just`][just].
```bash
$ just serve # to build and serve the wasm component on `localhost:8080`
$ curl localhost:8080 # to send requests to component.
```
Alternatively, run:
```bash
$ npm install
$ npm run build
$ wasmtime serve -S common dist/sample-wasi-http-js.wasm
```
## See Also
- [sample-wasi-http-rust][rust-sample] An example `wasi:http` server component written in Rust.
## License
Apache-2.0 with LLVM Exception
[jco]: https://github.com/bytecodealliance/jco
[just]: https://github.com/casey/just
[rust-sample]: https://github.com/bytecodealliance/sample-wasi-http-rust
[wasi-http]: https://github.com/WebAssembly/wasi-http
[wasmtime]: https://wasmtime.dev/