WinterJS 是一个极速的 JavaScript 服务器，能够根据 Winter 社区组规范运行 Service Workers 脚本。

WinterJS 在单台笔记本电脑上能够处理高达每秒 100,000 个请求（参见基准测试）。

注意：尽管名称中都包含"Winter"，但 WinterJS 并未得到 WinterCG 的官方认可。有许多支持 WinterCG 的运行时，WinterJS 只是其中之一。

使用 Wasmer 运行 WinterJS

WinterJS 服务器在 Wasmer 上以 wasmer/winterjs 的名称发布。

你可以通过以下命令在本地运行 HTTP 服务器：

wasmer run wasmer/winterjs --net --mapdir=tests:tests tests/simple.js

其中 simple.js 的内容为：

addEventListener('fetch', (req) => {
  req.respondWith(new Response('hello'));
});

从源代码构建

WinterJS 需要在其构建过程中从源代码构建 SpiderMonkey。请按照此处概述的步骤操作，以确保你已准备好构建 SpiderMonkey：https://github.com/wasmerio/mozjs/blob/master/README.md。

在使用 cargo install 安装 WinterJS（从源代码构建而不是下载预构建的二进制文件）之前，你也需要完成这些步骤。

此外，在调试模式下构建 WinterJS 时，你需要安装 NodeJS 和 npm，并预先运行 npm install。这是因为 WinterJS 的调试版本还会构建 src/builtins/internal_js_modules 中的 TypeScript 代码。发布版本使用该目录中现有的预编译 *.js 源文件。这样做是为了简化使用 cargo install 安装 WinterJS 的过程。如果你更新了 TypeScript 源文件，请确保至少在调试模式下构建一次，并提交更新后的 *.js 文件。

一旦你能够构建 SpiderMonkey，只需像往常一样运行 cargo build 来构建 WinterJS 本身。

原生运行 WinterJS

你可以通过以下命令原生安装 WinterJS：

cargo install --git https://github.com/wasmerio/winterjs winterjs

安装完 WinterJS 后，你可以简单地执行：

winterjs tests/simple.js

然后通过 https://localhost:8080/ 访问服务器。

WinterJS 的工作原理

WinterJS 由 SpiderMonkey、Spiderfire 和 hyper 提供支持，为你的 Javascript 应用带来全新水平的卓越性能。

WinterJS 使用 WASIX 标准编译为 WebAssembly。请注意，目前编译为 WASIX 是一个复杂的过程。我们建议使用 wasmer/winterjs 中的预编译版本，但如果你需要在本地编译为 WASIX，请开启一个问题。

局限性

WinterJS 完全符合 WinterCG 规范，尽管运行时本身仍在开发中。有关更多信息，请参阅下面的 API 兼容性部分。

WinterCG API 兼容性

随着 API 的添加/修复，本节将会更新。如果某个 API 在本节中未提及，则表示它尚未实现。

你可以在这里查看更详细的列表：https://runtime-compat.unjs.io/

以下词语用于描述 API 的状态：

✅ 稳定 - API 已实现并完全符合规范。这不包括原生代码中潜在的未发现的实现错误。
🔶 部分 - API 已实现但未完全符合规范和/或存在已知限制。
❌ 待定 - API 尚未实现。

API	状态	备注
`console`	✅ 稳定
`fetch`	✅ 稳定
`URL`	✅ 稳定
`URLSearchParams`	✅ 稳定
`Request`	✅ 稳定
`Headers`	✅ 稳定
`Response`	✅ 稳定
`Blob`	✅ 稳定
`File`	✅ 稳定
`FormData`	✅ 稳定
`TextDecoder`	✅ 稳定
`TextDecoderStream`	✅ 稳定
`TextEncoder`	✅ 稳定
`TextEncoderStream`	✅ 稳定
`ReadableStream` 及相关类型	✅ 稳定
`WritableStream` 及相关类型	✅ 稳定
`TransformStream` 及相关类型	🔶 部分	未实现背压
`atob`	✅ 稳定
`btoa`	✅ 稳定
`performance.now()`	✅ 稳定
`performance.timeOrigin`	✅ 稳定
`crypto`	✅ 稳定
`crypto.subtle`	🔶 部分	仅支持 HMAC、MD5 和 SHA 算法

其他支持的 API

以下（非 WinterCG）API 在 WinterJS 中已实现并可访问：

API	状态	备注
Service Workers Caches API	✅ 稳定	可通过 `caches` 访问。`caches.default`（类似于 Cloudflare workers）也可用。<br/>当前实现基于内存，缓存的响应在多次运行 WinterJS 之间不会持久保存。