Skip to content

Commit 9791647

Browse files
authored
wasm : add note about worker.js file generation [no ci] (#3133)
This commit updates the documentation for the WASM examples to include a note about the generation of the `worker.js` file. As of Emscripten 3.1.58 (April 2024), separate worker.js files are no longer generated and the worker is embedded in the main JS file. The motivation for this change is to inform users about the new behavior of Emscripten and why the `worker.js` file may not be present. Refs: #3123
1 parent 288304e commit 9791647

File tree

4 files changed

+20
-0
lines changed

4 files changed

+20
-0
lines changed

examples/bench.wasm/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,5 +28,10 @@ to the server's HTTP path:
2828
```
2929
# copy the produced page to your HTTP path
3030
cp bin/bench.wasm/* /path/to/html/
31+
cp bin/libbench.js /path/to/html/
3132
cp bin/libbench.worker.js /path/to/html/
3233
```
34+
35+
> 📝 **Note:** As of Emscripten 3.1.58 (April 2024), separate worker.js files are no
36+
> longer generated and the worker is embedded in the main JS file. So the worker
37+
> file will not be geneated for versions later than `3.1.58`.

examples/command.wasm/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,5 +28,10 @@ To run the example in a different server, you need to copy the following files
2828
to the server's HTTP path:
2929
```
3030
cp bin/command.wasm/* /path/to/html/
31+
cp bin/libcommand.js /path/to/html/
3132
cp bin/libcommand.worker.js /path/to/html/
3233
```
34+
35+
> 📝 **Note:** As of Emscripten 3.1.58 (April 2024), separate worker.js files are no
36+
> longer generated and the worker is embedded in the main JS file. So the worker
37+
> file will not be geneated for versions later than `3.1.58`.

examples/stream.wasm/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,5 +26,10 @@ to the server's HTTP path:
2626
```
2727
# copy the produced page to your HTTP path
2828
cp bin/stream.wasm/* /path/to/html/
29+
cp bin/libstream.js /path/to/html/
2930
cp bin/libstream.worker.js /path/to/html/
3031
```
32+
33+
> 📝 **Note:** As of Emscripten 3.1.58 (April 2024), separate worker.js files are no
34+
> longer generated and the worker is embedded in the main JS file. So the worker
35+
> file will not be geneated for versions later than `3.1.58`.

examples/whisper.wasm/README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,5 +48,10 @@ to the server's HTTP path:
4848
```
4949
# copy the produced page to your HTTP path
5050
cp bin/whisper.wasm/* /path/to/html/
51+
cp bin/libmain.js /path/to/html/
5152
cp bin/libmain.worker.js /path/to/html/
5253
```
54+
55+
> 📝 **Note:** As of Emscripten 3.1.58 (April 2024), separate worker.js files are no
56+
> longer generated and the worker is embedded in the main JS file. So the worker
57+
> file will not be geneated for versions later than `3.1.58`.

0 commit comments

Comments
 (0)