Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
assets	[ DIR ]	drwxr-xr-x	2025-12-31 20:37
addons.html	106.56 KB	-rw-r--r--	2025-03-27 09:56
addons.json.gz	10.95 KB	-rw-r--r--	2025-03-27 09:56
addons.md	39.76 KB	-rw-r--r--	2025-03-27 09:56
all.html	7.41 MB	-rw-r--r--	2025-03-27 09:56
all.json.gz	902.17 KB	-rw-r--r--	2025-03-27 09:56
assert.html	192.05 KB	-rw-r--r--	2025-03-27 09:56
assert.json.gz	13 KB	-rw-r--r--	2025-03-27 09:56
assert.md	66.51 KB	-rw-r--r--	2025-03-27 09:56
async_context.html	84.88 KB	-rw-r--r--	2025-03-27 09:56
async_context.json.gz	7.1 KB	-rw-r--r--	2025-03-27 09:56
async_context.md	24.68 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.html	88.11 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.json.gz	9.82 KB	-rw-r--r--	2025-03-27 09:56
async_hooks.md	30.51 KB	-rw-r--r--	2025-03-27 09:56
buffer.html	479.74 KB	-rw-r--r--	2025-03-27 09:56
buffer.json.gz	28.89 KB	-rw-r--r--	2025-03-27 09:56
buffer.md	148.96 KB	-rw-r--r--	2025-03-27 09:56
child_process.html	170.26 KB	-rw-r--r--	2025-03-27 09:56
child_process.json.gz	20.98 KB	-rw-r--r--	2025-03-27 09:56
child_process.md	70.69 KB	-rw-r--r--	2025-03-27 09:56
cli.html	161.74 KB	-rw-r--r--	2025-03-27 09:56
cli.json.gz	25.06 KB	-rw-r--r--	2025-03-27 09:56
cli.md	67.4 KB	-rw-r--r--	2025-03-27 09:56
cluster.html	91.42 KB	-rw-r--r--	2025-03-27 09:56
cluster.json.gz	9.48 KB	-rw-r--r--	2025-03-27 09:56
cluster.md	28.84 KB	-rw-r--r--	2025-03-27 09:56
console.html	60.27 KB	-rw-r--r--	2025-03-27 09:56
console.json.gz	6.07 KB	-rw-r--r--	2025-03-27 09:56
console.md	16.5 KB	-rw-r--r--	2025-03-27 09:56
corepack.html	23.41 KB	-rw-r--r--	2025-03-27 09:56
corepack.json.gz	2.55 KB	-rw-r--r--	2025-03-27 09:56
corepack.md	5.08 KB	-rw-r--r--	2025-03-27 09:56
crypto.html	523.1 KB	-rw-r--r--	2025-03-27 09:56
crypto.json.gz	45.94 KB	-rw-r--r--	2025-03-27 09:56
crypto.md	194.44 KB	-rw-r--r--	2025-03-27 09:56
debugger.html	28.99 KB	-rw-r--r--	2025-03-27 09:56
debugger.json.gz	3.12 KB	-rw-r--r--	2025-03-27 09:56
debugger.md	7.02 KB	-rw-r--r--	2025-03-27 09:56
deprecations.html	199.72 KB	-rw-r--r--	2025-03-27 09:56
deprecations.json.gz	23.9 KB	-rw-r--r--	2025-03-27 09:56
deprecations.md	98.32 KB	-rw-r--r--	2025-03-27 09:56
dgram.html	91.02 KB	-rw-r--r--	2025-03-27 09:56
dgram.json.gz	10.19 KB	-rw-r--r--	2025-03-27 09:56
dgram.md	30.99 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.html	97.27 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.json.gz	7.45 KB	-rw-r--r--	2025-03-27 09:56
diagnostics_channel.md	31.06 KB	-rw-r--r--	2025-03-27 09:56
dns.html	131.53 KB	-rw-r--r--	2025-03-27 09:56
dns.json.gz	15.74 KB	-rw-r--r--	2025-03-27 09:56
dns.md	52.17 KB	-rw-r--r--	2025-03-27 09:56
documentation.html	26.08 KB	-rw-r--r--	2025-03-27 09:56
documentation.json.gz	2.26 KB	-rw-r--r--	2025-03-27 09:56
documentation.md	4.74 KB	-rw-r--r--	2025-03-27 09:56
domain.html	49.31 KB	-rw-r--r--	2025-03-27 09:56
domain.json.gz	6.2 KB	-rw-r--r--	2025-03-27 09:56
domain.md	15.21 KB	-rw-r--r--	2025-03-27 09:56
embedding.html	26.64 KB	-rw-r--r--	2025-03-27 09:56
embedding.json.gz	3.01 KB	-rw-r--r--	2025-03-27 09:56
embedding.md	6.65 KB	-rw-r--r--	2025-03-27 09:56
errors.html	284.97 KB	-rw-r--r--	2025-03-27 09:56
errors.json.gz	42.36 KB	-rw-r--r--	2025-03-27 09:56
errors.md	97.03 KB	-rw-r--r--	2025-03-27 09:56
esm.html	89.14 KB	-rw-r--r--	2025-03-27 09:56
esm.json.gz	14.96 KB	-rw-r--r--	2025-03-27 09:56
esm.md	41.13 KB	-rw-r--r--	2025-03-27 09:56
events.html	230.85 KB	-rw-r--r--	2025-03-27 09:56
events.json.gz	17.25 KB	-rw-r--r--	2025-03-27 09:56
events.md	66.55 KB	-rw-r--r--	2025-03-27 09:56
fs.html	633.14 KB	-rw-r--r--	2025-03-27 09:56
fs.json.gz	67.08 KB	-rw-r--r--	2025-03-27 09:56
fs.md	248.67 KB	-rw-r--r--	2025-03-27 09:56
globals.html	75.67 KB	-rw-r--r--	2025-03-27 09:56
globals.json.gz	9 KB	-rw-r--r--	2025-03-27 09:56
globals.md	20.01 KB	-rw-r--r--	2025-03-27 09:56
http.html	301.5 KB	-rw-r--r--	2025-03-27 09:56
http.json.gz	35.76 KB	-rw-r--r--	2025-03-27 09:56
http.md	113.28 KB	-rw-r--r--	2025-03-27 09:56
http2.html	318.89 KB	-rw-r--r--	2025-03-27 09:56
http2.json.gz	39.24 KB	-rw-r--r--	2025-03-27 09:56
http2.md	129.92 KB	-rw-r--r--	2025-03-27 09:56
https.html	57.3 KB	-rw-r--r--	2025-03-27 09:56
https.json.gz	5.69 KB	-rw-r--r--	2025-03-27 09:56
https.md	16.33 KB	-rw-r--r--	2025-03-27 09:56
index.html	13.44 KB	-rw-r--r--	2025-03-27 09:56
index.json	54 B	-rw-r--r--	2025-03-27 09:56
index.md	1.97 KB	-rw-r--r--	2025-03-27 09:56
inspector.html	35.1 KB	-rw-r--r--	2025-03-27 09:56
inspector.json.gz	3.62 KB	-rw-r--r--	2025-03-27 09:56
inspector.md	7.63 KB	-rw-r--r--	2025-03-27 09:56
intl.html	32.73 KB	-rw-r--r--	2025-03-27 09:56
intl.json.gz	3.87 KB	-rw-r--r--	2025-03-27 09:56
intl.md	10.71 KB	-rw-r--r--	2025-03-27 09:56
module.html	99.46 KB	-rw-r--r--	2025-03-27 09:56
module.json.gz	12.9 KB	-rw-r--r--	2025-03-27 09:56
module.md	35.82 KB	-rw-r--r--	2025-03-27 09:56
modules.html	81.42 KB	-rw-r--r--	2025-03-27 09:56
modules.json.gz	12.66 KB	-rw-r--r--	2025-03-27 09:56
modules.md	32.97 KB	-rw-r--r--	2025-03-27 09:56
n-api.html	410.98 KB	-rw-r--r--	2025-03-27 09:56
n-api.json.gz	52.81 KB	-rw-r--r--	2025-03-27 09:56
n-api.md	223.67 KB	-rw-r--r--	2025-03-27 09:56
net.html	148.47 KB	-rw-r--r--	2025-03-27 09:56
net.json.gz	18.33 KB	-rw-r--r--	2025-03-27 09:56
net.md	53.5 KB	-rw-r--r--	2025-03-27 09:56
os.html	72.68 KB	-rw-r--r--	2025-03-27 09:56
os.json.gz	8.88 KB	-rw-r--r--	2025-03-27 09:56
os.md	35.5 KB	-rw-r--r--	2025-03-27 09:56
packages.html	101.35 KB	-rw-r--r--	2025-03-27 09:56
packages.json.gz	15.41 KB	-rw-r--r--	2025-03-27 09:56
packages.md	46.43 KB	-rw-r--r--	2025-03-27 09:56
path.html	53.27 KB	-rw-r--r--	2025-03-27 09:56
path.json.gz	4.9 KB	-rw-r--r--	2025-03-27 09:56
path.md	14.91 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.html	140.73 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.json.gz	12.51 KB	-rw-r--r--	2025-03-27 09:56
perf_hooks.md	42.15 KB	-rw-r--r--	2025-03-27 09:56
permissions.html	45.46 KB	-rw-r--r--	2025-03-27 09:56
permissions.json.gz	5.44 KB	-rw-r--r--	2025-03-27 09:56
permissions.md	14.59 KB	-rw-r--r--	2025-03-27 09:56
policy.html	15.05 KB	-rw-r--r--	2025-03-27 09:56
policy.json	476 B	-rw-r--r--	2025-03-27 09:56
policy.md	222 B	-rw-r--r--	2025-03-27 09:56
process.html	291.96 KB	-rw-r--r--	2025-03-27 09:56
process.json.gz	31.35 KB	-rw-r--r--	2025-03-27 09:56
process.md	107.1 KB	-rw-r--r--	2025-03-27 09:56
punycode.html	27.08 KB	-rw-r--r--	2025-03-27 09:56
punycode.json.gz	2 KB	-rw-r--r--	2025-03-27 09:56
punycode.md	4.17 KB	-rw-r--r--	2025-03-27 09:56
querystring.html	29.1 KB	-rw-r--r--	2025-03-27 09:56
querystring.json.gz	2.65 KB	-rw-r--r--	2025-03-27 09:56
querystring.md	5.57 KB	-rw-r--r--	2025-03-27 09:56
readline.html	110.11 KB	-rw-r--r--	2025-03-27 09:56
readline.json.gz	11.91 KB	-rw-r--r--	2025-03-27 09:56
readline.md	40.48 KB	-rw-r--r--	2025-03-27 09:56
repl.html	69.56 KB	-rw-r--r--	2025-03-27 09:56
repl.json.gz	10 KB	-rw-r--r--	2025-03-27 09:56
repl.md	23.69 KB	-rw-r--r--	2025-03-27 09:56
report.html	82.38 KB	-rw-r--r--	2025-03-27 09:56
report.json.gz	6.39 KB	-rw-r--r--	2025-03-27 09:56
report.md	18.83 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.html	26.11 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.json.gz	2.7 KB	-rw-r--r--	2025-03-27 09:56
single-executable-applications.md	6.1 KB	-rw-r--r--	2025-03-27 09:56
stream.html	399.91 KB	-rw-r--r--	2025-03-27 09:56
stream.json.gz	51.38 KB	-rw-r--r--	2025-03-27 09:56
stream.md	146.64 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.html	24.3 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.json.gz	1.55 KB	-rw-r--r--	2025-03-27 09:56
string_decoder.md	2.9 KB	-rw-r--r--	2025-03-27 09:56
synopsis.html	20.38 KB	-rw-r--r--	2025-03-27 09:56
synopsis.json	2.96 KB	-rw-r--r--	2025-03-27 09:56
synopsis.md	2.12 KB	-rw-r--r--	2025-03-27 09:56
test.html	227.62 KB	-rw-r--r--	2025-03-27 09:56
test.json.gz	20.4 KB	-rw-r--r--	2025-03-27 09:56
test.md	77.32 KB	-rw-r--r--	2025-03-27 09:56
timers.html	58.12 KB	-rw-r--r--	2025-03-27 09:56
timers.json.gz	5.28 KB	-rw-r--r--	2025-03-27 09:56
timers.md	15.81 KB	-rw-r--r--	2025-03-27 09:56
tls.html	181.66 KB	-rw-r--r--	2025-03-27 09:56
tls.json.gz	32.58 KB	-rw-r--r--	2025-03-27 09:56
tls.md	88.87 KB	-rw-r--r--	2025-03-27 09:56
tracing.html	35.22 KB	-rw-r--r--	2025-03-27 09:56
tracing.json.gz	3.47 KB	-rw-r--r--	2025-03-27 09:56
tracing.md	8.52 KB	-rw-r--r--	2025-03-27 09:56
tty.html	37.77 KB	-rw-r--r--	2025-03-27 09:56
tty.json.gz	3.72 KB	-rw-r--r--	2025-03-27 09:56
tty.md	8.91 KB	-rw-r--r--	2025-03-27 09:56
url.html	152.76 KB	-rw-r--r--	2025-03-27 09:56
url.json.gz	15.93 KB	-rw-r--r--	2025-03-27 09:56
url.md	54.46 KB	-rw-r--r--	2025-03-27 09:56
util.html	286.48 KB	-rw-r--r--	2025-03-27 09:56
util.json.gz	26.23 KB	-rw-r--r--	2025-03-27 09:56
util.md	96.24 KB	-rw-r--r--	2025-03-27 09:56
v8.html	112.17 KB	-rw-r--r--	2025-03-27 09:56
v8.json.gz	11.86 KB	-rw-r--r--	2025-03-27 09:56
v8.md	34.31 KB	-rw-r--r--	2025-03-27 09:56
vm.html	145.37 KB	-rw-r--r--	2025-03-27 09:56
vm.json.gz	16.9 KB	-rw-r--r--	2025-03-27 09:56
vm.md	61.11 KB	-rw-r--r--	2025-03-27 09:56
wasi.html	28.74 KB	-rw-r--r--	2025-03-27 09:56
wasi.json.gz	2.86 KB	-rw-r--r--	2025-03-27 09:56
wasi.md	6.54 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.html	153.34 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.json.gz	9.86 KB	-rw-r--r--	2025-03-27 09:56
webcrypto.md	45.75 KB	-rw-r--r--	2025-03-27 09:56
webstreams.html	151.84 KB	-rw-r--r--	2025-03-27 09:56
webstreams.json.gz	9.95 KB	-rw-r--r--	2025-03-27 09:56
webstreams.md	37.04 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.html	114.31 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.json.gz	14.46 KB	-rw-r--r--	2025-03-27 09:56
worker_threads.md	43.24 KB	-rw-r--r--	2025-03-27 09:56
zlib.html	109.68 KB	-rw-r--r--	2025-03-27 09:56
zlib.json.gz	10.34 KB	-rw-r--r--	2025-03-27 09:56
zlib.md	35.1 KB	-rw-r--r--	2025-03-27 09:56

Rename

# WebAssembly System Interface (WASI)

> Stability: 1 - Experimental

The WASI API provides an implementation of the [WebAssembly System Interface][]
specification. WASI gives sandboxed WebAssembly applications access to the
underlying operating system via a collection of POSIX-like functions.

```mjs
import { readFile } from 'node:fs/promises';
import { WASI } from 'wasi';
import { argv, env } from 'node:process';

const wasi = new WASI({
  args: argv,
  env,
  preopens: {
    '/sandbox': '/some/real/path/that/wasm/can/access',
  },
});

// Some WASI binaries require:
//   const importObject = { wasi_unstable: wasi.wasiImport };
const importObject = { wasi_snapshot_preview1: wasi.wasiImport };

const wasm = await WebAssembly.compile(
  await readFile(new URL('./demo.wasm', import.meta.url)),
);
const instance = await WebAssembly.instantiate(wasm, importObject);

wasi.start(instance);
```

```cjs
'use strict';
const { readFile } = require('node:fs/promises');
const { WASI } = require('wasi');
const { argv, env } = require('node:process');
const { join } = require('node:path');

const wasi = new WASI({
  args: argv,
  env,
  preopens: {
    '/sandbox': '/some/real/path/that/wasm/can/access',
  },
});

// Some WASI binaries require:
//   const importObject = { wasi_unstable: wasi.wasiImport };
const importObject = { wasi_snapshot_preview1: wasi.wasiImport };

(async () => {
  const wasm = await WebAssembly.compile(
    await readFile(join(__dirname, 'demo.wasm')),
  );
  const instance = await WebAssembly.instantiate(wasm, importObject);

wasi.start(instance);
})();
```

To run the above example, create a new WebAssembly text format file named
`demo.wat`:

```text
(module
    ;; Import the required fd_write WASI function which will write the given io vectors to stdout
    ;; The function signature for fd_write is:
    ;; (File Descriptor, *iovs, iovs_len, nwritten) -> Returns number of bytes written
    (import "wasi_snapshot_preview1" "fd_write" (func $fd_write (param i32 i32 i32 i32) (result i32)))

(memory 1)
    (export "memory" (memory 0))

;; Write 'hello world\n' to memory at an offset of 8 bytes
    ;; Note the trailing newline which is required for the text to appear
    (data (i32.const 8) "hello world\n")

(func $main (export "_start")
        ;; Creating a new io vector within linear memory
        (i32.store (i32.const 0) (i32.const 8))  ;; iov.iov_base - This is a pointer to the start of the 'hello world\n' string
        (i32.store (i32.const 4) (i32.const 12))  ;; iov.iov_len - The length of the 'hello world\n' string

(call $fd_write
            (i32.const 1) ;; file_descriptor - 1 for stdout
            (i32.const 0) ;; *iovs - The pointer to the iov array, which is stored at memory location 0
            (i32.const 1) ;; iovs_len - We're printing 1 string stored in an iov - so one.
            (i32.const 20) ;; nwritten - A place in memory to store the number of bytes written
        )
        drop ;; Discard the number of bytes written from the top of the stack
    )
)
```

Use [wabt](https://github.com/WebAssembly/wabt) to compile `.wat` to `.wasm`

```console
$ wat2wasm demo.wat
```

## Class: `WASI`

The `WASI` class provides the WASI system call API and additional convenience
methods for working with WASI-based applications. Each `WASI` instance
represents a distinct sandbox environment. For security purposes, each `WASI`
instance must have its command-line arguments, environment variables, and
sandbox directory structure configured explicitly.

### `new WASI([options])`

* `options` {Object}
  * `args` {Array} An array of strings that the WebAssembly application will
    see as command-line arguments. The first argument is the virtual path to the
    WASI command itself. **Default:** `[]`.
  * `env` {Object} An object similar to `process.env` that the WebAssembly
    application will see as its environment. **Default:** `{}`.
  * `preopens` {Object} This object represents the WebAssembly application's
    sandbox directory structure. The string keys of `preopens` are treated as
    directories within the sandbox. The corresponding values in `preopens` are
    the real paths to those directories on the host machine.
  * `returnOnExit` {boolean} By default, WASI applications terminate the Node.js
    process via the `__wasi_proc_exit()` function. Setting this option to `true`
    causes `wasi.start()` to return the exit code rather than terminate the
    process. **Default:** `false`.
  * `stdin` {integer} The file descriptor used as standard input in the
    WebAssembly application. **Default:** `0`.
  * `stdout` {integer} The file descriptor used as standard output in the
    WebAssembly application. **Default:** `1`.
  * `stderr` {integer} The file descriptor used as standard error in the
    WebAssembly application. **Default:** `2`.

### `wasi.start(instance)`

* `instance` {WebAssembly.Instance}

Attempt to begin execution of `instance` as a WASI command by invoking its
`_start()` export. If `instance` does not contain a `_start()` export, or if
`instance` contains an `_initialize()` export, then an exception is thrown.

`start()` requires that `instance` exports a [`WebAssembly.Memory`][] named
`memory`. If `instance` does not have a `memory` export an exception is thrown.

If `start()` is called more than once, an exception is thrown.

### `wasi.initialize(instance)`

* `instance` {WebAssembly.Instance}

Attempt to initialize `instance` as a WASI reactor by invoking its
`_initialize()` export, if it is present. If `instance` contains a `_start()`
export, then an exception is thrown.

`initialize()` requires that `instance` exports a [`WebAssembly.Memory`][] named
`memory`. If `instance` does not have a `memory` export an exception is thrown.

If `initialize()` is called more than once, an exception is thrown.

### `wasi.wasiImport`

* {Object}

`wasiImport` is an object that implements the WASI system call API. This object
should be passed as the `wasi_snapshot_preview1` import during the instantiation
of a [`WebAssembly.Instance`][].

[WebAssembly System Interface]: https://wasi.dev/
[`WebAssembly.Instance`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Instance
[`WebAssembly.Memory`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Memory