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

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