基准测试 – 项目 | Bun 文档

Bun 的设计目标是速度。热点路径经过广泛的性能分析和基准测试。所有 Bun 公开基准测试的源代码都可以在 Bun 代码仓库的 /bench 目录中找到。

测量时间

为了精确测量时间，Bun 提供了两个运行时 API 函数

Web 标准的 performance.now() 函数
Bun.nanoseconds()，它类似于 performance.now()，但它返回自应用程序启动以来经过的纳秒数。您可以使用 performance.timeOrigin 将其转换为 Unix 时间戳。

基准测试工具

在编写自己的基准测试时，选择正确的工具非常重要。

对于微基准测试，一个出色的通用工具是 mitata。
对于负载测试，您必须使用至少与 Bun.serve() 一样快的 HTTP 基准测试工具，否则您的结果将会偏差。一些流行的基于 Node.js 的基准测试工具，如 autocannon，速度不够快。我们推荐以下工具之一
对于基准测试脚本或 CLI 命令，我们推荐 hyperfine。

测量内存使用量

Bun 有两个堆。一个堆用于 JavaScript 运行时，另一个堆用于其他所有内容。

JavaScript 堆统计

bun:jsc 模块公开了一些用于测量内存使用量的函数

import { heapStats } from "bun:jsc";
console.log(heapStats());

查看示例统计信息

{
  heapSize: 1657575,
  heapCapacity: 2872775,
  extraMemorySize: 598199,
  objectCount: 13790,
  protectedObjectCount: 62,
  globalObjectCount: 1,
  protectedGlobalObjectCount: 1,
  // A count of every object type in the heap
  objectTypeCounts: {
    CallbackObject: 25,
    FunctionExecutable: 2078,
    AsyncGeneratorFunction: 2,
    'RegExp String Iterator': 1,
    FunctionCodeBlock: 188,
    ModuleProgramExecutable: 13,
    String: 1,
    UnlinkedModuleProgramCodeBlock: 13,
    JSON: 1,
    AsyncGenerator: 1,
    Symbol: 1,
    GetterSetter: 68,
    ImportMeta: 10,
    DOMAttributeGetterSetter: 1,
    UnlinkedFunctionCodeBlock: 174,
    RegExp: 52,
    ModuleLoader: 1,
    Intl: 1,
    WeakMap: 4,
    Generator: 2,
    PropertyTable: 95,
    'Array Iterator': 1,
    JSLexicalEnvironment: 75,
    UnlinkedFunctionExecutable: 2067,
    WeakSet: 1,
    console: 1,
    Map: 23,
    SparseArrayValueMap: 14,
    StructureChain: 19,
    Set: 18,
    'String Iterator': 1,
    FunctionRareData: 3,
    JSGlobalLexicalEnvironment: 1,
    Object: 481,
    BigInt: 2,
    StructureRareData: 55,
    Array: 179,
    AbortController: 2,
    ModuleNamespaceObject: 11,
    ShadowRealm: 1,
    'Immutable Butterfly': 103,
    Primordials: 1,
    'Set Iterator': 1,
    JSGlobalProxy: 1,
    AsyncFromSyncIterator: 1,
    ModuleRecord: 13,
    FinalizationRegistry: 1,
    AsyncIterator: 1,
    InternalPromise: 22,
    Iterator: 1,
    CustomGetterSetter: 65,
    Promise: 19,
    WeakRef: 1,
    InternalPromisePrototype: 1,
    Function: 2381,
    AsyncFunction: 2,
    GlobalObject: 1,
    ArrayBuffer: 2,
    Boolean: 1,
    Math: 1,
    CallbackConstructor: 1,
    Error: 2,
    JSModuleEnvironment: 13,
    WebAssembly: 1,
    HashMapBucket: 300,
    Callee: 3,
    symbol: 37,
    string: 2484,
    Performance: 1,
    ModuleProgramCodeBlock: 12,
    JSSourceCode: 13,
    JSPropertyNameEnumerator: 3,
    NativeExecutable: 290,
    Number: 1,
    Structure: 1550,
    SymbolTable: 108,
    GeneratorFunction: 2,
    'Map Iterator': 1
  },
  protectedObjectTypeCounts: {
    CallbackConstructor: 1,
    BigInt: 1,
    RegExp: 2,
    GlobalObject: 1,
    UnlinkedModuleProgramCodeBlock: 13,
    HashMapBucket: 2,
    Structure: 41,
    JSPropertyNameEnumerator: 1
  }
}

JavaScript 是一种垃圾回收语言，而不是引用计数。在所有情况下，对象不立即被释放是正常且正确的，尽管对象永远不被释放是不正常的。

要强制手动运行垃圾回收

Bun.gc(true); // synchronous
Bun.gc(false); // asynchronous

堆快照允许您检查哪些对象未被释放。您可以使用 bun:jsc 模块来拍摄堆快照，然后使用 Safari 或 WebKit GTK 开发者工具查看它。要生成堆快照

import { generateHeapSnapshot } from "bun";

const snapshot = generateHeapSnapshot();
await Bun.write("heap.json", JSON.stringify(snapshot, null, 2));

要查看快照，请在 Safari 的开发者工具（或 WebKit GTK）中打开 heap.json 文件

打开开发者工具
点击 “时间线”
点击左侧菜单中的 “JavaScript 分配”。在您点击铅笔图标以显示所有时间线之前，它可能不可见
点击 “导入” 并选择您的堆快照 JSON 文件

导入后，您应该看到类似这样的内容

Viewing heap snapshot in Safari — 在 Safari 开发者工具中查看堆快照

Web 调试器还提供了时间线功能，允许您跟踪和检查正在运行的调试会话的内存使用情况。

原生堆统计

Bun 使用 mimalloc 作为另一个堆。要报告非 JavaScript 内存使用情况的摘要，请设置 MIMALLOC_SHOW_STATS=1 环境变量。统计信息将在退出时打印。

MIMALLOC_SHOW_STATS=1 bun script.js

# will show something like this:
heap stats:    peak      total      freed    current       unit      count
  reserved:   64.0 MiB   64.0 MiB      0       64.0 MiB                        not all freed!
 committed:   64.0 MiB   64.0 MiB      0       64.0 MiB                        not all freed!
     reset:      0          0          0          0                            ok
   touched:  128.5 KiB  128.5 KiB    5.4 MiB   -5.3 MiB                        ok
  segments:      1          1          0          1                            not all freed!
-abandoned:      0          0          0          0                            ok
   -cached:      0          0          0          0                            ok
     pages:      0          0         53        -53                            ok
-abandoned:      0          0          0          0                            ok
 -extended:      0
 -noretire:      0
     mmaps:      0
   commits:      0
   threads:      0          0          0          0                            ok
  searches:     0.0 avg
numa nodes:       1
   elapsed:       0.068 s
   process: user: 0.061 s, system: 0.014 s, faults: 0, rss: 57.4 MiB, commit: 64.0 MiB