EmscriptenModule

Defined in: packages/runtime/src/wasm/types.ts:261

An initialized Emscripten module instance (result of the MODULARIZE factory).

Only the fields that wasmExec and the TTY bridge touch are typed — the full Emscripten module surface is large and intentionally left opaque.

Properties

Asyncify?

optional Asyncify?: EmscriptenAsyncify

Defined in: packages/runtime/src/wasm/types.ts:296

Asyncify runtime — present when compiled with -sASYNCIFY and exported.

---

ENV?

optional ENV?: Record<string, string>

Defined in: packages/runtime/src/wasm/types.ts:288

Emscripten’s environment variables — set before calling main().

---

FS

FS: EmscriptenFS

Defined in: packages/runtime/src/wasm/types.ts:263

Emscripten’s in-memory filesystem.

---

noExitRuntime?

optional noExitRuntime?: boolean

Defined in: packages/runtime/src/wasm/types.ts:273

If true, exit() does not abort the runtime — required for Asyncify.

---

noInitialRun?

optional noInitialRun?: boolean

Defined in: packages/runtime/src/wasm/types.ts:271

If true, the factory resolves without invoking main().

---

preRun?

optional preRun?: (m) => void[]

Defined in: packages/runtime/src/wasm/types.ts:283

Hooks run before main() — inject env vars here.

Parameters

m

EmscriptenModule

Returns

void

---

thisProgram?

optional thisProgram?: string

Defined in: packages/runtime/src/wasm/types.ts:285

argv[0] value the program sees.

---

TTY?

optional TTY?: EmscriptenTTY

Defined in: packages/runtime/src/wasm/types.ts:298

TTY subsystem — present when TTY is added to EXPORTED_RUNTIME_METHODS.

---

wasmBinary?

optional wasmBinary?: Uint8Array<ArrayBufferLike>

Defined in: packages/runtime/src/wasm/types.ts:269

Pre-provided WASM binary (bypasses Emscripten’s built-in fetch/locateFile).

Methods

_main()

_main(argc, argv): number

Defined in: packages/runtime/src/wasm/types.ts:267

Direct entry point — use instead of callMain() with Asyncify to avoid exitJS.

Parameters

argc

number

argv

number

Returns

number

---

callMain()

callMain(args): number

Defined in: packages/runtime/src/wasm/types.ts:265

Run the program’s main() with the given argv (argv[0] is excluded).

Parameters

args

string[]

Returns

number

---

locateFile()?

optional locateFile(path, prefix): string

Defined in: packages/runtime/src/wasm/types.ts:293

Override Emscripten’s file locator. When wasmBinary is provided this prevents the glue from calling new URL(name, import.meta.url) which fails when the glue is evaluated outside its original module context.

Parameters

path

string

prefix

string

Returns

string

---

onExit()?

optional onExit(code): void

Defined in: packages/runtime/src/wasm/types.ts:281

Called when the program exits with the exit code.

Parameters

code

number

Returns

void

---

print()?

optional print(text): void

Defined in: packages/runtime/src/wasm/types.ts:275

Override for normal stdout print.

Parameters

text

string

Returns

void

---

printErr()?

optional printErr(text): void

Defined in: packages/runtime/src/wasm/types.ts:277

Override for stderr print.

Parameters

text

string

Returns

void

---

stdin()?

optional stdin(): number | null

Defined in: packages/runtime/src/wasm/types.ts:279

Synchronous stdin callback — returns next byte, or null on EOF.

Returns

number | null