wasm-check


Library for detect WebAssembly post-MVP features in NodeJS & Browser. Small and with zero dependencies.
---

About post-MVP WebAssembly features

https://github.com/WebAssembly/design/blob/master/FutureFeatures.md#tracking-issues

_Tests on Canary with flags:_

Enable some experimental features for Chrome Canary (Mac):
``
/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary --js-flags="--experimental-wasm-eh"
`

Support feature detections

- [x] Reference types _(standardized)_
- [x] BigInt between js and wasm _(standardized)_
- [x] Bulk memory operations _(standardized)_
- [x] Memory 64-bit _(--experimental-wasm-memory64)_
- [x] Exceptions _(--experimental-wasm-eh)_
- [x] Multi values _(standardized)_
- [x] Tail recursion calls _(--experimental-wasm-return-call)_
- [x] Saturated (non-trapping) conversions from float to int _(standardized)_
- [x] Sign extensions _(standardized)_
- [x] SIMD _(standardized)_
- [x] Threads _(standardized)_
- [x] Type reflection _(--experimental-wasm-type-reflection)_

Install

`
yarn add wasm-check
`

or

`
npm i wasm-check
`

Usage

#### Check supported WebAssembly version

`ts
import * as check from 'wasm-check';
// or
// const check = require('wasm-check');

console.log(check.support()); // WebAssembly 1.0 (MVP)
console.log(check.support(1)); // ^^^
console.log(check.support(2)); // WebAssembly 2.0
`

#### Check supporting streaming compilation

`ts
import * as check from 'wasm-check';

console.log(check.supportStreaming);
`

#### Get all post-MVP WebAssembly features

`ts
import * as check from 'wasm-check';

const features = { ...check.feature };
console.log(features);
`

Output:

`js
{
bigInt: true,
bulk: true,
exceptions: false,
memory64: false,
mutableGlobal: true,
multiValue: true,
saturateConversions: true,
signExtensions: true,
tailCall: false,
threads: false,
simd: false,
references: false,
typeReflection: false,
funcReferences: false
}
`

#### Or check concrete feature

`ts
import * as check from 'wasm-check';

console.log(check.feature.simd); // has SIMD support?
console.log(check.feature.tailCalls); // has tail call optimization support?
``

#### TODO

- [ ] GC integration feature check