wasm-feature-detect

What is wasm-feature-detect?

The wasm-feature-detect npm package is designed to help developers detect the availability of various WebAssembly (Wasm) features in the user's environment. This can be particularly useful for ensuring compatibility and optimizing performance by leveraging specific Wasm capabilities when they are available.

What are wasm-feature-detect's main functionalities?

Detect SIMD Support

This feature allows you to detect if SIMD (Single Instruction, Multiple Data) is supported in the user's environment. SIMD can significantly improve performance for certain types of computations.

const wasmFeatureDetect = require('wasm-feature-detect');

wasmFeatureDetect.simd().then(supported => {
  if (supported) {
    console.log('SIMD is supported');
  } else {
    console.log('SIMD is not supported');
  }
});

Detect Bulk Memory Operations Support

This feature checks if bulk memory operations are supported. Bulk memory operations can be used to efficiently manage memory in WebAssembly.

const wasmFeatureDetect = require('wasm-feature-detect');

wasmFeatureDetect.bulkMemory().then(supported => {
  if (supported) {
    console.log('Bulk Memory Operations are supported');
  } else {
    console.log('Bulk Memory Operations are not supported');
  }
});

Detect Multi-Value Support

This feature detects if the multi-value extension is supported. Multi-value allows WebAssembly functions to return multiple values, which can simplify certain programming patterns.

const wasmFeatureDetect = require('wasm-feature-detect');

wasmFeatureDetect.multiValue().then(supported => {
  if (supported) {
    console.log('Multi-Value is supported');
  } else {
    console.log('Multi-Value is not supported');
  }
});

Other packages similar to wasm-feature-detect

wasm-check

The wasm-check package is another alternative for detecting WebAssembly features. It provides a simple API to check for the availability of specific Wasm capabilities. While it covers many of the same features as wasm-feature-detect, it may have a different set of supported features and a different API design.

README

WebAssembly Feature Detection

A small library (700B gzip’d) to detect which features of WebAssembly are supported in your current browser.

Installation

npm install -g wasm-feature-detect

Usage

<script type="module">
  import { simd } from "https://unpkg.com/wasm-feature-detect?module";

  simd().then(simdSupported => {
    if (simdSupported) {
      /* SIMD support */
    } else {
      /* No SIMD support */
    }
  });
</script>

If required, there’s also a UMD version

<script src="https://unpkg.com/wasm-feature-detect/dist/umd/index.js"></script>
<script>
  wasmFeatureDetect.simd().then(/* same as above */);
</script>

Detectors

All detectors return a Promise<bool>.

Function	Proposal
bulkMemory()	Bulk memory operations
exceptions()	Exception handling
multiValue()	Multi-value
mutableGlobals()	Importable/Exportable mutable globals
referenceTypes()	Reference Types
saturatedFloatToInt()	Non-trapping float-to-int conversions
signExtensions()	Sign-extension operators
simd()	Fixed-Width SIMD
tailCall()	Tail call
threads()	Threads

Why are all the tests async?

The technical reason is that some tests might have to be augmented to be asynchronous in the future. For example, Firefox is planning to make a change that would require a postMessage call to detect SABs, which are required for threads.

The other reason is that you should be using WebAssembly.compile, WebAssembly.instantiate, or their streaming versions WebAssembly.compileStreaming and WebAssembly.instantiateStreaming, which are all asynchronous. You should already be prepared for asynchronous code when using WebAssembly!

---

License Apache-2.0