d8ac01bc76
Signed-off-by: joshvanl <me@joshvanl.dev> |
||
|---|---|---|
| .. | ||
| example | ||
| internal | ||
| Makefile | ||
| README.md | ||
| benchmark_test.go | ||
| httpwasm.go | ||
| httpwasm_test.go | ||
README.md
WebAssembly Middleware
This component lets you manipulate an incoming request or serve a response with custom logic compiled using the htp-wasm Application Binary Interface (ABI). The handle_request function receives an incoming request and can manipulate it or serve a response as necessary.
Please see the documentation for general configuration.
Generating Wasm
To compile your wasm, you must compile source using an SDK such as http-wasm-guest-tinygo. You can also make a copy of hello.go and replace the handler.HandleFn function with your custom logic.
If using TinyGo, compile like so and set the url attribute to "file://router.wasm":
tinygo build -o router.wasm -scheduler=none --no-debug -target=wasi router.go`
Notes
- This is an alpha feature, so configuration is subject to change.
- This module implements the host side of the http-wasm handler protocol.
- This uses wazero for the WebAssembly runtime as it has no dependencies, nor relies on CGO. This allows installation without shared libraries.
- Many WebAssembly compilers leave memory unbounded and/or set to 16MB. To avoid resource exhaustion, assign concurrency controls.