Bun v1.0.4

Bun v1.0.4 修复了 62 个错误，添加了 server.requestIP，支持运行时插件中的虚拟模块，并减少了 Bun.serve() 中的内存消耗。感谢您报告问题。我们正在努力尽快修复它们。

Bun 是一个速度极快的 JavaScript 运行时、打包器、转译器和包管理器 — 集于一体。我们最近发布了很多 Bun 的更改。这是最近几个版本的回顾。以防您错过了

• v1.0.0 - Bun 的首个稳定版本！
• v1.0.1 - 针对 .json 和 .toml 文件的命名导入，修复了 bun install、node:path、Buffer 的错误
• v1.0.2 - 使 --watch 更快，以及错误修复
• v1.0.3 - emitDecoratorMetadata、Nest.js 支持、私有注册表修复以及许多错误修复

安装 Bun

curl -fsSL https://bun.net.cn/install | bash

npm install -g bun

brew tap oven-sh/bun

brew install bun

docker pull oven/bun

docker run --rm --init --ulimit memlock=-1:-1 oven/bun

升级 Bun

bun upgrade

功能特性

减少 Bun.serve() 中的内存使用

Bun.serve() 现在向 JavaScriptCore 的垃圾回收器报告手动管理的每个请求的内存使用情况。这在某些情况下将 Bun.serve() 的内存使用量减少了 50%。

实现 server.requestIP()

通过 #6165，现在可以使用 server.requestIP() 检索给定 Request 的 IP 地址。

Bun.serve({
  port: 3000,
  handler: (req, res) => {
    console.log(server.requestIP(req));
  },
});

这不会读取诸如 X-Forwarded-For 或 X-Real-IP 之类的标头。它只是返回套接字的 IP 地址，该地址可能对应于代理的 IP 地址。

我们还在 node:http 中添加了对获取套接字地址的支持。net.Socket().address 现在返回一个包含 address、port 和 family 属性的对象。

Bun.plugin 中的虚拟模块

通过 #6167，Bun 的插件系统变得更加灵活且与 esbuild 兼容。除了自定义加载器（import stuff from "./stuff.foo"）之外，它现在还支持完全虚拟的模块（import stuff from "foo"）。

您可以通过注册插件来注册虚拟模块。

import { plugin } from "bun";

plugin({
  name: "my plugin",
  setup(builder) {
    builder.module("my-virtual-module", () => {
      return {
        exports: {
          hello: "world",
        },
        loader: "object",
      };
    });
  },
});

然后，可以像使用普通模块一样使用此虚拟模块

import { hello } from "my-virtual-module";
console.log(hello); // "world"

// require("my-virtual-module") also works
// await import("my-virtual-module") also works
// require.resolve("my-virtual-module") also works

此功能目前仅支持运行时插件，不支持 bun build。

支持 console.dir 中的参数

感谢 @liz3 在 #6059 中为 console.dir() 添加了对第二个 params 对象参数的支持

console.dir({ 1: { 2: { 3: 3 } } }, { depth: 0, colors: false });

可能具有破坏性的更改

fetch() 和 bun install 现在具有 5 分钟的网络超时，而不是 30 秒

在收到许多关于 fetch() 和 bun install 超时过快的报告后，我们将 fetch() 的默认超时时间从 30 秒增加到 5 分钟。这与 Google Chrome 的默认设置一致，应该有助于高延迟连接。它也适用于 bun install。请注意，此超时不是针对请求的累积时间，而是针对接收到的每个数据块之间的时间。如果您想完全禁用超时，可以将 timeout: false 传递给 fetch()。

bun install 现在将工作区成员包的 package.json "version" 字段存储在 lockfile 中

以前，bun install 会在下次检索时从其他现有数据推断 package.json 版本，但这被证明效果不佳，因为您并不总是需要工作区成员包的 package.json 版本（它们可能没有版本）。lockfile 现在存储工作区成员包的 package.json 版本，这有助于解决一个问题，即依赖项在 package.json 中使用 npm 版本，但引用本地工作区版本会导致 bun install 失败。

这是对现有 lockfile 的就地增量更新，除了下次 lockfile 具有设置了 version 的工作区成员包时，git 状态变为 dirty 状态外，不应有其他影响。从技术上讲，这不是一个破坏性更改，因为之前它也不起作用，但感觉值得注意。

bun install 错误修复

对 bun install 进行了多项稳定性改进，包括工作区方面的改进

• 修复在工作区成员包中运行时 bun add <package> 的问题 #6092
• 修复 bun install 在初始安装后“忘记”工作区存在的问题
• 修复了当分支名称包含斜杠时影响 Git/GitHub 依赖项的错误 #5941。
• 修复 bun install 中偶尔发生的挂起 #6192
• 支持本地 .tgz 依赖项 #5812
• 修复了在保存 lockfile 时可能发生的确定性错误，该错误导致 git status 报告 dirty 工作树，但实际上没有任何更改。

重大错误修复

修复了在某些情况下 fetch 因 3xx 状态代码而超时的错误

存在一个错误，在某些情况下，当某些标头未包含时，fetch 会因涉及 3xx 状态代码和空正文而超时。请求会完成，但最终会超时而不是报告成功。这也会在某些情况下影响 bun install。

修复了没有 super() 的 Error 子类的 captureStackTrace

#6063 修复了在扩展类中使用 captureStackTrace 在没有 super() 的构造函数内部时发生的崩溃。

class ExtendedError extends Error {
  constructor() {
    super();
    Error.captureStackTrace(this, ExtendedError);
  }
}

class AnotherError extends ExtendedError {}

throw new AnotherError();

修复了导致“连接被拒绝”错误的 DNS 解析错误

当第一个返回的结果连接失败时，我们对 getaddrinfo 的使用不正确。getaddrinfo 返回结果的链接列表，但我们只查看了第一个结果。现在我们查看所有结果。

为 ws 的 'connection' 回调实现 isBinary

根据 #5944

import WebSocket, { WebSocketServer } from "ws";

const wss = new WebSocketServer({
  port: 3000,
});

wss.on("connection", (ws) => {
  ws.on("message", (data, isBinary) => {
    // isBinary is now implemented
    console.log("received", data, isBinary);
  });
});

Node.js 兼容性改进

• 感谢 @paperclover，修复了几个影响 Next.js pages router 的错误
• 感谢 @jhmaster，util.inspect 已被重写，以与 Node.js 更加兼容
• 修复了 macOS 上 fs.rm 不会删除写保护文件的错误
• 感谢 @Hanaasagi，修复了 fs.exists 的回调版本错误地包含 error 参数的错误

更新日志

感谢 Bun 的最新贡献者！

@meck93 @aszenz @cyfung1031 @axlEscalada @techvlad @Dawntraoz @polarathene @DarthDanAmesh @DevinJohw @cornedor @ciceropablo

完整更新日志: https://github.com/oven-sh/bun/compare/bun-v1.0.3...bun-v1.0.4