chore: add docs and changeset

callstack · Dec 5, 2023 · dec8791 · dec8791
1 parent 10419a1
commit dec8791
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 0 deletions.
diff --git a/.changeset/nasty-cars-attack.md b/.changeset/nasty-cars-attack.md
@@ -0,0 +1,6 @@
+---
+'@callstack/reassure-cli': patch
+'reassure': patch
+---
+
+feat: Experimental options to enable WebAssembly (--enable-wasm)
diff --git a/docusaurus/docs/troubleshooting.md b/docusaurus/docs/troubleshooting.md
@@ -0,0 +1,18 @@
+---
+title: Troubleshooting
+sidebar_position: 5
+---
+
+### Handling `ReferenceError: WebAssembly is not defined`
+
+Reassure, by default, uses Node.js's `--jitless` flag to disable its optimizing compiler to increase test stability. This flag prevents WebAssembly (WASM) from running because of internal Node.js architecture. In some cases, you might still allow your tests to include code depending on WASM, e.g., the `fetch` method is implemented using WASM.
+
+In such cases, pass the `--enable-wasm` flag to Reassure CLI:
+
+```sh
+$ reassure --enable-wasm
+```
+
+This option will replace the Node.js `--jitless` flag with alternative flags to achieve a similar stabilizing effect.
+
+Note that this option is experimental and may negatively affect the stability of your tests.