mirror of
https://github.com/bytecodealliance/wasm-micro-runtime.git
synced 2025-02-06 06:55:07 +00:00
41b2c6d0d5
- add default build configuration options and enhance message output for WAMR features - Add Wasm proposal status printing functionality
83 lines
4.2 KiB
Markdown
83 lines
4.2 KiB
Markdown
# 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` |
|
|
| Threads[^4] | Yes | `WAMR_BUILD_SHARED_MEMORY` |
|
|
| 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).
|