2025-01-09 05:13:30 +00:00
# Wasm Proposals
This document is intended to describe the current status of WebAssembly proposals and WASI proposals in WAMR.
Only track proposals that are followed in the [WebAssembly proposals ](https://github.com/WebAssembly/proposals ) and [WASI proposals ](https://github.com/WebAssembly/WASI/blob/main/Proposals.md ).
Normally, the document tracks proposals that are in phase 4. However, if a proposal in an earlier phase receives support, it will be added to the list below.
The _status_ represents the configuration _product-mini/platforms/linux/CMakeLists.txt_ . There may be minor differences between the top-level CMakeLists and platform-specific CMakeLists.
Users can turn those features on or off by using compilation options. If a relevant compilation option is not available(`N/A`), it indicates that the feature is permanently enabled.
## On-by-default Wasm Proposals
| Proposal | >= Phase 4 | Compilation Option |
| ------------------------------------- | ---------- | ------------------------ |
| Bulk memory operations | Yes | `WAMR_BUILD_BULK_MEMORY` |
| Extended Constant Expressions | Yes | N/A |
| Fixed-width SIMD[^1] | Yes | `WAMR_BUILD_SIMD` |
| Multi-value | Yes | N/A |
| Non-trapping float-to-int conversions | Yes | N/A |
| Reference Types | Yes | `WAMR_BUILD_REF_TYPES` |
| Sign-extension operators | Yes | N/A |
| WebAssembly C and C++ API | No | N/A |
[^1]: llvm-jit and aot only.
## Off-by-default Wasm Proposals
| Proposal | >= Phase 4 | Compilation Option |
| ----------------------------- | ---------- | -------------------------- |
| Garbage collection | Yes | `WAMR_BUILD_GC` |
| Legacy Exception handling[^2] | No | `WAMR_BUILD_EXCE_HANDLING` |
| Memory64 | Yes | `WAMR_BUILD_MEMORY64` |
| Multiple memories[^3] | Yes | `WAMR_BUILD_MULTI_MEMORY` |
| Reference-Typed Strings | No | `WAMR_BUILD_STRINGREF` |
| Tail call | Yes | `WAMR_BUILD_TAIL_CALL` |
2025-02-05 07:28:26 +00:00
| Threads[^4] | Yes | `WAMR_BUILD_SHARED_MEMORY` |
2025-01-09 05:13:30 +00:00
| Typed Function References | Yes | `WAMR_BUILD_GC` |
[^2]:
interpreter only. [a legacy version ](https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/legacy/Exceptions.md ).
This proposal is currently also known as the "legacy proposal" and still
supported in the web, but can be deprecated in future and the use of
this proposal is discouraged.
[^3]: interpreter only
[^4]: `WAMR_BUILD_LIB_PTHREAD` can also be used to enable
## Unimplemented Wasm Proposals
| Proposal | >= Phase 4 |
| ------------------------------------------- | ---------- |
| Branch Hinting | Yes |
| Custom Annotation Syntax in the Text Format | Yes |
| Exception handling[^5] | Yes |
| Import/Export of Mutable Globals | Yes |
| JS String Builtins | Yes |
| Relaxed SIMD | Yes |
[^5]: [up-to-date version ](https://github.com/WebAssembly/exception-handling/blob/main/proposals/exception-handling/Exceptions.md )
## On-by-default WASI Proposals
| Proposal | >= Phase 4 | Compilation Option |
| -------- | ---------- | ------------------ |
## Off-by-default WASI Proposals
| Proposal | >= Phase 4 | Compilation Option |
| -------------------------- | ---------- | ----------------------------- |
| Machine Learning (wasi-nn) | No | `WAMR_BUILD_WASI_NN` |
| Threads | No | `WAMR_BUILD_LIB_WASI_THREADS` |
## Unimplemented WASI Proposals
| Proposal | >= Phase 4 |
| -------- | ---------- |
## WAMR features
WAMR offers a variety of customizable features to create a highly efficient runtime. For more details, please refer to [build_wamr ](./build_wamr.md ).
