vite-plugin-wasm
Add WebAssembly ESM integration (aka. Webpack's asyncWebAssembly
) to Vite and support wasm-pack
generated modules.
Installation
For Vite 3.x (latest), please use 2.x version of this plugin (pure ESM, since Vite is pure ESM):
yarn add -D vite-plugin-wasm@^2
For Vite 2.x (latest), please use 1.x version of this plugin:
yarn add -D vite-plugin-wasm@^1
Usage
You also need the vite-plugin-top-level-await
plugin unless you target very modern browsers only (i.e. set build.target
to esnext
).
import wasm from "vite-plugin-wasm";
import topLevelAwait from "vite-plugin-top-level-await";
export default defineConfig({
plugins: [
wasm(),
topLevelAwait()
]
});
Notes
TypeScript typing is broken. Since we can't declare a module with Record<string, any>
as its named export map. Your import ... from "./module.wasm";
will still got Vite's bulit-in typing, but the transformed code is fine. So just use an asterisk import import * as wasmModule from "./module.wasm"
and type assertion (you have typing for your WASM files, right?).