@runno/wasi
    Preparing search index...

    Class WASIX

    WASIX runtime for the browser.

    Sibling of WASI (not a subclass). Composes a WASI instance internally to service wasi_snapshot_preview1 and wasi_unstable imports. Filesystem syscalls route through a FileSystemProvider; clock and random go through their respective providers. Memory marshalling lives in this class — providers only ever see decoded JS-native values.

    Usage mirrors WASI.start():

    const result = await WASIX.start(fetch('/bin/hello.wasm'), new WASIXContext({ … }));

    Index

    Constructors

    constructor

    Properties

    context hasBeenInitialized instance memory module

    Methods

    getImportObject resolveEnvImports start start

    Constructors

    Properties

    context: WASIXContext
    hasBeenInitialized: boolean = false
    instance: Instance
    memory: Memory
    module: Module

    Methods

    • Parameters

      • env: { indirectFunctionTable?: Table; memory?: Memory } = {}

      Returns {
          env: ModuleImports;
          wasi_snapshot_preview1: {
              fd_prestat_dir_name: (
                  fd: number,
                  pathPtr: number,
                  pathLen: number,
              ) => number;
              fd_prestat_get: (fd: number, retptr: number) => number;
              fd_readdir: (
                  fd: number,
                  bufPtr: number,
                  bufLen: number,
                  cookie: bigint,
                  retptr: number,
              ) => number;
              path_create_directory: (
                  fdDir: number,
                  pathPtr: number,
                  pathLen: number,
              ) => number;
              path_filestat_get: (
                  fdDir: number,
                  dirflags: number,
                  pathPtr: number,
                  pathLen: number,
                  retptr: number,
              ) => number;
              path_open: (
                  fdDir: number,
                  dirflags: number,
                  pathPtr: number,
                  pathLen: number,
                  oflags: number,
                  rightsBase: bigint,
                  rightsInheriting: bigint,
                  fdflags: number,
                  retptr: number,
              ) => number;
              path_remove_directory: (
                  fdDir: number,
                  pathPtr: number,
                  pathLen: number,
              ) => number;
              path_rename: (
                  oldFd: number,
                  oldPathPtr: number,
                  oldPathLen: number,
                  newFd: number,
                  newPathPtr: number,
                  newPathLen: number,
              ) => number;
              path_unlink_file: (
                  fdDir: number,
                  pathPtr: number,
                  pathLen: number,
              ) => number;
              proc_exit: (code: number) => never;
              args_get(argv_ptr: number, argv_buf_ptr: number): number;
              args_sizes_get(argc_ptr: number, argv_buf_size_ptr: number): number;
              clock_res_get(id: number, retptr0: number): number;
              clock_time_get(id: number, precision: bigint, retptr0: number): number;
              environ_get(env_ptr_ptr: number, env_buf_ptr: number): number;
              environ_sizes_get(env_ptr: number, env_buf_size_ptr: number): number;
              fd_advise(
                  fd: number,
                  offset: bigint,
                  length: bigint,
                  advice: number,
              ): number;
              fd_allocate(fd: number, offset: bigint, length: bigint): number;
              fd_close(fd: number): number;
              fd_datasync(fd: number): number;
              fd_fdstat_get(fd: number, retptr0: number): number;
              fd_fdstat_set_flags(fd: number, flags: number): number;
              fd_fdstat_set_rights(
                  fd: number,
                  fs_rights_base: bigint,
                  fs_rights_inheriting: bigint,
              ): number;
              fd_filestat_get(fd: number, retptr0: number): number;
              fd_filestat_set_size(fd: number, size: bigint): number;
              fd_filestat_set_times(
                  fd: number,
                  atim: bigint,
                  mtim: bigint,
                  fst_flags: number,
              ): number;
              fd_pread(
                  fd: number,
                  iovs_ptr: number,
                  iovs_len: number,
                  offset: bigint,
                  retptr0: number,
              ): number;
              fd_pwrite(
                  fd: number,
                  ciovs_ptr: number,
                  ciovs_len: number,
                  offset: bigint,
                  retptr0: number,
              ): number;
              fd_read(
                  fd: number,
                  iovs_ptr: number,
                  iovs_len: number,
                  retptr0: number,
              ): number;
              fd_renumber(old_fd: number, new_fd: number): number;
              fd_seek(
                  fd: number,
                  offset: bigint,
                  whence: number,
                  retptr0: number,
              ): number;
              fd_sync(fd: number): number;
              fd_tell(fd: number, retptr0: number): number;
              fd_write(
                  fd: number,
                  ciovs_ptr: number,
                  ciovs_len: number,
                  retptr0: number,
              ): number;
              path_filestat_set_times(
                  fd: number,
                  flags: number,
                  path_ptr: number,
                  path_len: number,
                  atim: bigint,
                  mtime: bigint,
                  fst_flags: number,
              ): number;
              path_link(
                  old_fd: number,
                  old_flags: number,
                  old_path_ptr: number,
                  old_path_len: number,
                  new_fd: number,
                  new_path_ptr: number,
                  new_path_len: number,
              ): number;
              path_readlink(
                  fd: number,
                  path_ptr: number,
                  path_len: number,
                  buf_ptr: number,
                  buf_len: number,
                  retptr0: number,
              ): number;
              path_symlink(
                  old_path_ptr: number,
                  old_path_len: number,
                  fd: number,
                  new_path_ptr: number,
                  new_path_len: number,
              ): number;
              poll_oneoff(
                  in_ptr: number,
                  out_ptr: number,
                  nsubscriptions: number,
                  retptr0: number,
              ): number;
              proc_raise(signal: number): number;
              random_get(buffer_ptr: number, buffer_len: number): number;
              sched_yield(): number;
              sock_accept(fd: number, flags: number): number;
              sock_recv(
                  fd: number,
                  ri_data_ptr: number,
                  ri_data_len: number,
                  ri_flags: number,
                  retptr0: number,
                  retptr1: number,
              ): number;
              sock_send(
                  fd: number,
                  si_data_ptr: number,
                  si_data_len: number,
                  si_flags: number,
                  retptr0: number,
              ): number;
              sock_shutdown(fd: number, how: number): number;
          };
          wasi_unstable: {
              proc_exit: (code: number) => never;
              args_get(argv_ptr: number, argv_buf_ptr: number): number;
              args_sizes_get(argc_ptr: number, argv_buf_size_ptr: number): number;
              clock_res_get(id: number, retptr0: number): number;
              clock_time_get(id: number, precision: bigint, retptr0: number): number;
              environ_get(env_ptr_ptr: number, env_buf_ptr: number): number;
              environ_sizes_get(env_ptr: number, env_buf_size_ptr: number): number;
              fd_advise(
                  fd: number,
                  offset: bigint,
                  length: bigint,
                  advice: number,
              ): number;
              fd_allocate(fd: number, offset: bigint, length: bigint): number;
              fd_close(fd: number): number;
              fd_datasync(fd: number): number;
              fd_fdstat_get(fd: number, retptr0: number): number;
              fd_fdstat_set_flags(fd: number, flags: number): number;
              fd_fdstat_set_rights(
                  fd: number,
                  fs_rights_base: bigint,
                  fs_rights_inheriting: bigint,
              ): number;
              fd_filestat_get(fd: number, retptr0: number): number;
              fd_filestat_set_size(fd: number, size: bigint): number;
              fd_filestat_set_times(
                  fd: number,
                  atim: bigint,
                  mtim: bigint,
                  fst_flags: number,
              ): number;
              fd_pread(
                  fd: number,
                  iovs_ptr: number,
                  iovs_len: number,
                  offset: bigint,
                  retptr0: number,
              ): number;
              fd_prestat_dir_name(
                  fd: number,
                  path_ptr: number,
                  path_len: number,
              ): number;
              fd_prestat_get(fd: number, retptr0: number): number;
              fd_pwrite(
                  fd: number,
                  ciovs_ptr: number,
                  ciovs_len: number,
                  offset: bigint,
                  retptr0: number,
              ): number;
              fd_read(
                  fd: number,
                  iovs_ptr: number,
                  iovs_len: number,
                  retptr0: number,
              ): number;
              fd_readdir(
                  fd: number,
                  buf: number,
                  buf_len: number,
                  cookie: bigint,
                  retptr0: number,
              ): number;
              fd_renumber(old_fd: number, new_fd: number): number;
              fd_seek(
                  fd: number,
                  offset: bigint,
                  whence: number,
                  retptr0: number,
              ): number;
              fd_sync(fd: number): number;
              fd_tell(fd: number, retptr0: number): number;
              fd_write(
                  fd: number,
                  ciovs_ptr: number,
                  ciovs_len: number,
                  retptr0: number,
              ): number;
              path_create_directory(
                  fd: number,
                  path_ptr: number,
                  path_len: number,
              ): number;
              path_filestat_get(
                  fd: number,
                  flags: number,
                  path_ptr: number,
                  path_len: number,
                  retptr0: number,
              ): number;
              path_filestat_set_times(
                  fd: number,
                  flags: number,
                  path_ptr: number,
                  path_len: number,
                  atim: bigint,
                  mtime: bigint,
                  fst_flags: number,
              ): number;
              path_link(
                  old_fd: number,
                  old_flags: number,
                  old_path_ptr: number,
                  old_path_len: number,
                  new_fd: number,
                  new_path_ptr: number,
                  new_path_len: number,
              ): number;
              path_open(
                  fd: number,
                  dir_flags: number,
                  path_ptr: number,
                  path_len: number,
                  oflags: number,
                  rights_base: bigint,
                  rights_inheriting: bigint,
                  fdflags: number,
                  retptr0: number,
              ): number;
              path_readlink(
                  fd: number,
                  path_ptr: number,
                  path_len: number,
                  buf_ptr: number,
                  buf_len: number,
                  retptr0: number,
              ): number;
              path_remove_directory(
                  fd: number,
                  path_ptr: number,
                  path_len: number,
              ): number;
              path_rename(
                  old_fd: number,
                  old_path_ptr: number,
                  old_path_len: number,
                  new_fd: number,
                  new_path_ptr: number,
                  new_path_len: number,
              ): number;
              path_symlink(
                  old_path_ptr: number,
                  old_path_len: number,
                  fd: number,
                  new_path_ptr: number,
                  new_path_len: number,
              ): number;
              path_unlink_file(fd: number, path_ptr: number, path_len: number): number;
              poll_oneoff(
                  in_ptr: number,
                  out_ptr: number,
                  nsubscriptions: number,
                  retptr0: number,
              ): number;
              proc_raise(signal: number): number;
              random_get(buffer_ptr: number, buffer_len: number): number;
              sched_yield(): number;
              sock_accept(fd: number, flags: number): number;
              sock_recv(
                  fd: number,
                  ri_data_ptr: number,
                  ri_data_len: number,
                  ri_flags: number,
                  retptr0: number,
                  retptr1: number,
              ): number;
              sock_send(
                  fd: number,
                  si_data_ptr: number,
                  si_data_len: number,
                  si_flags: number,
                  retptr0: number,
              ): number;
              sock_shutdown(fd: number, how: number): number;
          };
          wasix_32v1: ModuleImports;
      }

    • Convert the parsed env.* import descriptors into concrete WebAssembly.Memory / WebAssembly.Table instances, honouring any host overrides on the context. Either result may be undefined when the binary doesn't import the corresponding entry (preview1-style binaries that export their own memory, for example).

      Parameters

      • descriptors: ParsedEnvImports

      Returns { indirectFunctionTable?: Table; memory?: Memory }

    • Start a WASIX command.

      Buffers the module bytes so we can parse the import section ourselves: WebAssembly.Module.imports(module) returns only the { module, name, kind } triple — descriptors (memory limits, shared flag, table element type) are not in the standard surface. We need those to construct a matching WebAssembly.Memory / WebAssembly.Table for env.memory / env.__indirect_function_table, so the parse runs over the raw bytes before compile.

      Parameters

      Returns Promise<WASIXExecutionResult>

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods