@bytecodealliance/jco-std

这个 @bytecodealliance/jco 子项目包含共享功能和 用于在 Javascript 中构建 Web Assembly 组件的可重复使用的库.

Web大会组件 是使用组件模型的网络大会二进制, 用于互操作的WebAssembly库、应用程序和环境的不断发展的架构.

WebAssembly 组件可以从服务器侧式应用程序使用 财务报告和审定财务报表 在浏览器中,以及 @bytecodealliance/jco-std 包含两种环境的共享功能和辅助工具.

@bytecodealliance/preview2-shim 是选入时使用的可选对等依赖 节点执行 wasi:tls。使用此提供者的应用程序必须共享 同样的shim 实例与他们的 WASI 套接字和流: 单独的例子 不同的资源类 和IO工人。 使用符合 已安装 jco-std 释放的对等要求。 其他消费者并不需要这个.

适配器

以下是由下列人员提供的适配器列表: @bytecodealliance/jco-std数字 :

HTTP 密码

节点JS API(实验)

jco-std 还提供实验性节点JS API,用于工具如 jco 改为 将NodeJS程序建设为组件.

快速启动

@bytecodealliance/jco-std 本节通过出口可以以各种方式使用 包含一些如何快速启动的例子.

Http( 通过Hono适配器)

用于 @bytecodealliance/jco-std 建楼 浩诺 webAssembly 的应用程序, 使用该 @bytecodealliance/jco-std/http/adapters/hono 导出 :

import { Hono } from "hono";

import { fire } from "@bytecodealliance/jco-std/wasi/0.2.x/http/adapters/hono/server";

const app = new Hono();
app.get("/", () => "Hello World!");

fire(app);

// Although we've called `fire()` with wasi HTTP configured for use above,
// we still need to actually export the `wasi:http/incoming-handler` interface object,
// as componentize-js will be looking for the ES module export.
export { incomingHandler } from "@bytecodealliance/jco-std/wasi/0.2.x/http/adapters/hono/server";

[注] 我们用 @bytecodealliance/jco-std/wasi/0.2.x但是,如果你想使用一个特定的版本,你可以 使用明确版本的导出像 @bytecodealliance/jco-std/wasi/0.2.12。 。 。 .

这个 0.2.x 路径选择用组件化JS验证的最新 WASI 0.2 适配器 jco使用的版本. 它可能改变任何 jco-std 释放。 使用明确的版本 当您的组件必须保留一个更古老的WIT世界时,路径.

节点.js 兼容 API

[尖叫声] Jco的节点.js 组件的内置兼容性是实验性和主题 改为: API、行为和生成的组件接口可能改变 不相容,没有 铸币大释放.

上表列出了可用的适配器. 通常应用代码 保留它 node: 进口和让 jco componentize 选择执行. 见 节点.js 内置兼容性指南 用于设置、版本、能力和兼容性边界.

node:path

import path, { matchesGlob } from "node:path";
import { join as winJoin } from "node:path/win32";

export function outputPath(name) {
  if (!matchesGlob(name, "**/*.js")) throw new TypeError("expected JavaScript");
  return `${path.resolve("dist", name)}|${winJoin("C:\\dist", name)}`;
}

见 node:path。 。 。 .

node:string_decoder

import { Buffer } from "node:buffer";
import { StringDecoder } from "node:string_decoder";

const decoder = new StringDecoder("utf8");
decoder.write(Buffer.from([0xf0, 0x9f]));
decoder.end(Buffer.from([0x8c, 0x8d])); // "🌍"

见 node:string_decoder。 。 。 .

node:repl

import repl from "node:repl";

export function attach(input, output) {
  const server = repl.start({ prompt: "app> ", input, output, useGlobal: true });
  server.context.app = { version: "1.0.0" };
  return server;
}

见 node:repl。 。 。 .

node:tty

import { ReadStream, WriteStream, isatty } from "node:tty";

export function terminal() {
  if (!isatty(0) || !isatty(1)) throw new Error("a terminal is required");
  return { input: new ReadStream(0), output: new WriteStream(1) };
}

见 node:tty。 。 。 .

node:wasi

import { WASI } from "node:wasi";

export function createWasi() {
  return new WASI({ version: "preview1" });
}

见 node:wasi。 。 。 .

节点.js 错误全局

export function describeFailure() {
  const cause = new TypeError("invalid input");
  return new Error("operation failed", { cause }).cause.message;
}

见 节点.js 错误全局。 。 。 .

node:child_process

import { execFileSync } from "node:child_process";

export function nodeVersion() {
  return execFileSync("node", ["--version"], { encoding: "utf8" }).trim();
}

见 node:child_process。 。 。 .

node:fs

import { readFileSync } from "node:fs";
import { writeFile } from "node:fs/promises";

export async function replace(path, contents) {
  await writeFile(path, contents);
  return readFileSync(path, "utf8");
}

见 node:fs。 。 。 .

node:os

import os from "node:os";

export function hostSummary() {
  return `${os.platform()} ${os.arch()} (${os.availableParallelism()} CPUs)`;
}

见 node:os。 。 。 .

node:dns

import dns from "node:dns";
import dnsPromises from "node:dns/promises";

export function configuredServers() {
  return [...dns.getServers(), ...dnsPromises.getServers()];
}

见 node:dns。 。 。 .

node:net

import { connect, createServer } from "node:net";

createServer((socket) => socket.end("hello")).listen(8080, "127.0.0.1");
connect(8080, "127.0.0.1").setEncoding("utf8").on("data", console.log);

见 node:net。 。 。 .

node:http 财务报告和审定财务报表 node:https

import { createServer } from "node:http";
import { get } from "node:https";

createServer((request, response) => {
  response.end(`received ${request.method} ${request.url}`);
}).listen(8080, "127.0.0.1");

get("https://example.com/", (response) => response.resume());

见 node:http 财务报告和审定财务报表 node:https。 。 。 .

node:http2

import { connect } from "node:http2";

const session = connect("https://example.com");
const stream = session.request({ ":path": "/status" });
stream.on("end", () => session.close());
stream.end();

见 node:http2。 。 。 .

node:timers

import { setTimeout as delay, scheduler } from "node:timers/promises";

await delay(10, "ready");
await scheduler.yield();

见 node:timers。 。 。 .

许可证

这个项目根据Apache 2.0许可证获得许可,LLVM例外. 见 自由主义 更多细节.

捐款

除非您另有明确声明,否则有意提交的任何捐款 根据Apache-2.0许可证的定义, 应照此办理,不附加任何条件.