rake doc:api_js

Author: kateinoigakukun

packages/npm-packages/ruby-wasm-wasi/README.md

@@ -18,6 +18,41 @@ See [Cheat Sheet](https://github.com/ruby/ruby.wasm/blob/main/docs/cheat_sheet.m
 
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
+### consolePrinter
+
+Create a console printer that can be used as an overlay of WASI imports.
+See the example below for how to use it.
+
+```javascript
+const imports = {
+  wasi_snapshot_preview1: wasi.wasiImport,
+};
+const printer = consolePrinter();
+printer.addToImports(imports);
+
+const instance = await WebAssembly.instantiate(module, imports);
+printer.setMemory(instance.exports.memory);
+```
+
+Note that the `stdout` and `stderr` functions are called with text, not
+bytes. This means that bytes written to stdout/stderr will be decoded as
+UTF-8 and then passed to the `stdout`/`stderr` functions every time a write
+occurs without buffering.
+
+#### Parameters
+
+- `$0` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** (optional, default `{stdout:console.log,stderr:console.warn}`)
+
+  - `$0.stdout` &#x20;
+  - `$0.stderr` &#x20;
+
+- `stdout` A function that will be called when stdout is written to.
+  Defaults to `console.log`.
+- `stderr` A function that will be called when stderr is written to.
+  Defaults to `console.warn`.
+
+Returns **any** An object that can be used as an overlay of WASI imports.
+
 ### RubyVM
 
 A Ruby VM instance
@@ -46,7 +81,7 @@ Initialize the Ruby VM with the given command line arguments
 ##### Parameters
 
 - `args` The command line arguments to pass to Ruby. Must be
-  an array of strings starting with the Ruby program name. (optional, default `["ruby.wasm","--disable-gems","-EUTF-8","-e_=0"]`)
+  an array of strings starting with the Ruby program name. (optional, default `["ruby.wasm","-EUTF-8","-e_=0"]`)
 
 #### setInstance
 
@@ -151,6 +186,37 @@ ary.call("push", 4);
 console.log(ary.call("sample").toString());
 ```
 
+Returns **any** The result of the method call as a new RbValue.
+
+#### callAsync
+
+Call a given method that may call `JS::Object#await` with given arguments
+
+##### Parameters
+
+- `callee` name of the Ruby method to call
+- `args` **...any** arguments to pass to the method. Must be an array of RbValue
+
+##### Examples
+
+```javascript
+const client = vm.eval(`
+  require 'js'
+  class HttpClient
+    def get(url)
+      JS.global.fetch(url).await
+    end
+  end
+  HttpClient.new
+`);
+const response = await client.callAsync(
+  "get",
+  vm.eval(`"https://example.com"`),
+);
+```
+
+Returns **any** A Promise that resolves to the result of the method call as a new RbValue.
+
 #### toPrimitive
 
 - **See**: <https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive>