emscripten-core/emscripten

Feature request: MAIN_THREAD_EM_ASYNC_JS

Open

#16.694 geöffnet am 11. Apr. 2022

Auf GitHub ansehen
 (1 Kommentar) (0 Reaktionen) (0 zugewiesene Personen)C++ (27.361 Stars) (3.519 Forks)batch import
good first bughelp wanted

Beschreibung

EM_ASYNC_JS is really useful for writing async JS code with await, however it runs on the thread it was called on. It would be nice if there were a version that proxied the call to the main thread.

The alternative is to use MAIN_THREAD_ASYNC_EM_ASM (extra boilerplate with Asyncify.handleAsync and doesn't define a C function like EM_ASYNC_JS does):

MAIN_THREAD_ASYNC_EM_ASM({
    return Asyncify.handleAsync(async () => {
        // ....
    });
});

and then setting -s 'ASYNCIFY_IMPORTS=["emscripten_receive_on_main_thread_js"]'

related https://github.com/emscripten-core/emscripten/issues/8991#issuecomment-846440750

Contributor Guide

Tech Stack
javascriptccppwasm
Domain
toolingdeveloper experience
Issue Type
feature
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
4
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
over 1 week
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
stale
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
Emscripten build systemAsyncify APIWebAssembly threadingJavaScript async/await
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
15
Research-Richtung
Understand the current EM ASYNC JS implementation, likely in src/emscripten settings.js or src/asyncify.js. Examine how MAIN THREAD ASYNC EM ASM uses Asyncify.handleAsync. Review the linked issue #8991 and comment for prior discussion. Propose a new macro that combines the EM ASYNC JS syntax with main thread proxying, possibly by leveraging the existing `emscripten receive on main thread js` import.