1
|
declare module 'wasi' {
|
2
|
interface WASIOptions {
|
3
|
/**
|
4
|
* An array of strings that the WebAssembly application will
|
5
|
* see as command line arguments. The first argument is the virtual path to the
|
6
|
* WASI command itself.
|
7
|
*/
|
8
|
args?: string[];
|
9
|
/**
|
10
|
* An object similar to `process.env` that the WebAssembly
|
11
|
* application will see as its environment.
|
12
|
*/
|
13
|
env?: object;
|
14
|
/**
|
15
|
* This object represents the WebAssembly application's
|
16
|
* sandbox directory structure. The string keys of `preopens` are treated as
|
17
|
* directories within the sandbox. The corresponding values in `preopens` are
|
18
|
* the real paths to those directories on the host machine.
|
19
|
*/
|
20
|
preopens?: {
|
21
|
[key: string]: string;
|
22
|
};
|
23
|
|
24
|
/**
|
25
|
* By default, WASI applications terminate the Node.js
|
26
|
* process via the `__wasi_proc_exit()` function. Setting this option to `true`
|
27
|
* causes `wasi.start()` to return the exit code rather than terminate the
|
28
|
* process.
|
29
|
* @default false
|
30
|
*/
|
31
|
returnOnExit?: boolean;
|
32
|
}
|
33
|
|
34
|
class WASI {
|
35
|
constructor(options?: WASIOptions);
|
36
|
/**
|
37
|
*
|
38
|
* Attempt to begin execution of `instance` by invoking its `_start()` export.
|
39
|
* If `instance` does not contain a `_start()` export, then `start()` attempts to
|
40
|
* invoke the `__wasi_unstable_reactor_start()` export. If neither of those exports
|
41
|
* is present on `instance`, then `start()` does nothing.
|
42
|
*
|
43
|
* `start()` requires that `instance` exports a [`WebAssembly.Memory`][] named
|
44
|
* `memory`. If `instance` does not have a `memory` export an exception is thrown.
|
45
|
*/
|
46
|
start(instance: object): void; // TODO: avoid DOM dependency until WASM moved to own lib.
|
47
|
/**
|
48
|
* Is an object that implements the WASI system call API. This object
|
49
|
* should be passed as the `wasi_unstable` import during the instantiation of a
|
50
|
* [`WebAssembly.Instance`][].
|
51
|
*/
|
52
|
readonly wasiImport: { [key: string]: any }; // TODO: Narrow to DOM types
|
53
|
}
|
54
|
}
|