Troubleshooting

Kotlin/Wasm relies on new WebAssembly proposals like garbage collection and exception handling to introduce improvements and new features within WebAssembly.

However, to ensure these features work properly, you need an environment that supports the new proposals. In some cases, you may need to set up the environment to make it compatible with the proposals.

Browser versions

To run applications built with Kotlin/Wasm in a browser, you need a browser version supporting the new WebAssembly garbage collection (WasmGC) feature. Check if the browser version supports the new WasmGC by default or if you need to make changes to the environment.

Chrome

For version 119 or later:
Works by default.
For older versions:
To run applications in an older browser, you need a Kotlin version older than 1.9.20.
1. In your browser, go to chrome://flags/#enable-webassembly-garbage-collection.
2. Enable WebAssembly Garbage Collection.
3. Relaunch your browser.

Chromium-based

Including Chromium-based browsers such as Edge, Brave, Opera, or Samsung Internet.

For version 119 or later:
Works by default.
For older versions:
To run applications in an older browser, you need a Kotlin version older than 1.9.20.
Run the application with the --js-flags=--experimental-wasm-gc command line argument.

Firefox

For version 120 or later:
Works by default.
For version 119:
1. In your browser, go to about:config.
2. Enable javascript.options.wasm_gc option.
3. Refresh the page.

Safari/WebKit

WebAssembly garbage collection support is currently under active development.

Last modified: 22 March 2024