Add Rhai book.
This commit is contained in:
18
doc/src/start/builds/wasm.md
Normal file
18
doc/src/start/builds/wasm.md
Normal file
@@ -0,0 +1,18 @@
|
||||
Building to WebAssembly (WASM)
|
||||
=============================
|
||||
|
||||
{{#include ../../links.md}}
|
||||
|
||||
It is possible to use Rhai when compiling to WebAssembly (WASM). This yields a scripting engine (and language)
|
||||
that can be run in a standard web browser. Why you would want to is another matter... as there is already
|
||||
a nice, fast, complete scripting language for the the common WASM environment (i.e. a browser) - and it is called JavaScript.
|
||||
But anyhow, do it because you _can_!
|
||||
|
||||
When building for WASM, certain features will not be available, such as the script file API's and loading modules
|
||||
from external script files.
|
||||
|
||||
Also look into [minimal builds] to reduce generated WASM size. As of this version, a typical, full-featured
|
||||
Rhai scripting engine compiles to a single WASM file less than 200KB gzipped. When excluding features that are
|
||||
marginal in WASM environment, the gzipped payload can be further shrunk to 160KB.
|
||||
|
||||
In benchmark tests, a WASM build runs scripts roughly 1.7-2.2x slower than a native optimized release build.
|
Reference in New Issue
Block a user