Skip to content

Conversation

@hoodmane
Copy link
Contributor

@hoodmane hoodmane commented Jul 19, 2025

This is useful for implementing proper input(). It requires the JavaScript engine to support the wasm JSPI spec which is now stage 4. It is supported on Chrome since version 137 and on Firefox and node behind a flag.

We override the __wasi_fd_read() syscall with our own variant that checks for a readAsync operation. If it has it, we use our own async variant of fd_read(), otherwise we use the original fd_read(). We also add a variant of FS.createDevice() called FS.createAsyncInputDevice().

Finally, if JSPI is available, we wrap the main() symbol with WebAssembly.promising() so that we can stack switch from fd_read(). If JSPI is not available, attempting to read from an AsyncInputDevice will raise an OSError.

@hoodmane
Copy link
Contributor Author

!buildbot emscripten

@bedevere-bot
Copy link

🤖 New build scheduled with the buildbot fleet by @hoodmane for commit 3d573d5 🤖

Results will be shown at:

https://buildbot.python.org/all/#/grid?branch=refs%2Fpull%2F136822%2Fmerge

The command will test the builders whose names match following regular expression: emscripten

The builders matched are:

  • WASM Emscripten PR

hoodmane added 3 commits July 19, 2025 16:25
This is useful for implementing proper `input()`. It requires the
JavaScript engine to support the wasm JSPI spec which is now stage 4.
It is supported on Chrome since version 137 and on Firefox and node
behind a flag.

We override the `__wasi_fd_read()` syscall with our own variant that
checks for a readAsync operation. If it has it, we use our own async
variant of `fd_read()`, otherwise we use the original `fd_read()`.
We also add a variant of `FS.createDevice()` called
`FS.createAsyncInputDevice()`.

Finally, if JSPI is available, we wrap the `main()` symbol with
`WebAssembly.promising()` so that we can stack switch from `fd_read()`.
If JSPI is not available, attempting to read from an AsyncInputDevice
will raise an `OSError`.
@hoodmane hoodmane force-pushed the emscripten-async-input-device branch from 3d573d5 to 7d0e709 Compare July 19, 2025 14:26
@hoodmane hoodmane changed the title gh-136810: Emscripten: Add support for async input devices gh-124621: Emscripten: Add support for async input devices Jul 19, 2025
@ambv ambv merged commit 7ae4749 into python:main Jul 19, 2025
40 checks passed
@bedevere-app