Node.js 相容性 – 執行階段 | Bun 文件

每天，Bun 都更接近 100% Node.js API 相容性。如今，諸如 Next.js、Express 等流行的框架，以及數百萬個旨在用於 Node 的 npm 套件，都能與 Bun 協同運作。為了確保相容性，我們會在 Bun 的每個版本發布前，執行 Node.js 測試套件中的數千個測試。

如果一個套件在 Node.js 中可以運作，但在 Bun 中卻無法運作，我們會將其視為 Bun 的錯誤。請開啟 issue，我們會修復它。

此頁面會定期更新，以反映最新版本 Bun 的相容性狀態。以下資訊反映 Bun 與Node.js v23的相容性。

內建 Node.js 模組

`node:events`

🟢 完全實作。EventEmitterAsyncResource 底層使用 AsyncResource。EventEmitter 的 Node.js 測試套件通過率達 100%。

`node:punycode`

🟢 完全實作。Node.js 測試套件通過率達 100%，Node.js 已棄用。

`node:async_hooks`

🟡 已實作 AsyncLocalStorage 和 AsyncResource。v8 promise hooks 未被調用，且強烈建議不要使用。

`node:child_process`

🟡 缺少 proc.gid proc.uid。未匯出 Stream 類別。IPC 無法傳送 socket handles。Node.js 與 Bun 之間的 IPC 可以使用 JSON 序列化。

`node:cluster`

🟡 Worker 之間無法傳遞 handles 和 file descriptors，這表示目前僅在 Linux 上支援跨進程的 HTTP 請求負載平衡 (透過 SO_REUSEPORT)。其他部分已實作但未經過實戰測試。

`node:crypto`

🟡 缺少 ECDH checkPrime checkPrimeSync generatePrime generatePrimeSync hkdf hkdfSync secureHeapUsed setEngine setFips

某些方法尚未最佳化。

`node:http2`

🟡 已實作客戶端和伺服器 (通過 95.25% 的 gRPC 測試套件)。缺少 options.allowHTTP1、options.enableConnectProtocol、ALTSVC 擴展和 http2stream.pushStream。

🟡 缺少 runMain syncBuiltinESMExports、Module#load()。支援覆寫 ESM 和 CJS 模組的 require.cache。module._extensions、module._pathCache、module._cache 為 no-ops。module.register 尚未實作，我們建議在此期間使用 Bun.plugin。

`node:net`

🟡 SocketAddress 類別未公開 (但已實作)。BlockList 存在但為 no-op。

`node:perf_hooks`

🟡 缺少 createHistogram monitorEventLoopDelay。建議使用全域的 performance 而非 perf_hooks.performance。

`node:process`

🟡 請參閱 process 全域物件。

`node:sys`

🟡 請參閱 node:util。

`node:tls`

🟡 缺少 tls.createSecurePair。

`node:util`

🟡 缺少 getCallSite getCallSites getSystemErrorMap getSystemErrorMessage transferableAbortSignal transferableAbortController MIMEType MIMEParams

`node:v8`

🟡 已實作 writeHeapSnapshot 和 getHeapSnapshot。serialize 和 deserialize 使用 JavaScriptCore 的 wire format 而非 V8 的格式。其他方法尚未實作。如需效能分析，請改用 bun:jsc。

`node:vm`

🟡 核心功能可運作，但實驗性的 VM ES 模組尚未實作，包括 vm.Module、vm.SourceTextModule、vm.SyntheticModule、importModuleDynamically 和 vm.measureMemory。timeout、breakOnSigint、cachedData 等選項尚未實作。

`node:wasi`

🟡 部分實作。

`node:worker_threads`

🟡 Worker 不支援以下選項：stdin stdout stderr trackedUnmanagedFds resourceLimits。缺少 markAsUntransferable moveMessagePortToContext getHeapSnapshot。

`node:inspector`

🔴 尚未實作。

`node:repl`

🔴 尚未實作。

`node:sqlite`

🔴 尚未實作。

`node:test`

🔴 尚未實作。請改用 bun:test。

`node:trace_events`

🔴 尚未實作。

Node.js 全域物件

下表列出 Node.js 實作的所有全域物件以及 Bun 目前的相容性狀態。

`AbortController`

🟢 完全實作。

`AbortSignal`

🟢 完全實作。

`Blob`

🟢 完全實作。

`Buffer`

🟢 完全實作。

`ByteLengthQueuingStrategy`

🟢 完全實作。

`__dirname`

🟢 完全實作。

`__filename`

🟢 完全實作。

`atob()`

🟢 完全實作。

`BroadcastChannel`

🟢 完全實作。

`btoa()`

🟢 完全實作。

`clearImmediate()`

🟢 完全實作。

`clearInterval()`

🟢 完全實作。

`clearTimeout()`

🟢 完全實作。

`CompressionStream`

🔴 尚未實作。

`console`

🟢 完全實作。

`CountQueuingStrategy`

🟢 完全實作。

`Crypto`

🟢 完全實作。

`SubtleCrypto (crypto)`

🟢 完全實作。

`CryptoKey`

🟢 完全實作。

`CustomEvent`

🟢 完全實作。

`DecompressionStream`

🔴 尚未實作。

`Event`

🟢 完全實作。

`EventTarget`

🟢 完全實作。

`exports`

🟢 完全實作。

`fetch`

🟢 完全實作。

`FormData`

🟢 完全實作。

`global`

🟢 已實作。這是一個包含全域命名空間中所有物件的物件。它很少被直接引用，因為它的內容在沒有額外前綴的情況下可用，例如 __dirname 而不是 global.__dirname。

`globalThis`

🟢 global 的別名。

`Headers`

🟢 完全實作。

`MessageChannel`

🟢 完全實作。

`MessageEvent`

🟢 完全實作。

`MessagePort`

🟢 完全實作。

`module`

🟢 完全實作。

`PerformanceEntry`

🟢 完全實作。

`PerformanceMark`

🟢 完全實作。

`PerformanceMeasure`

🟢 完全實作。

`PerformanceObserver`

🟢 完全實作。

`PerformanceObserverEntryList`

🟢 完全實作。

`PerformanceResourceTiming`

🟢 完全實作。

`performance`

🟢 完全實作。

`process`

🟡 大部分已實作。process.binding (某些套件依賴的內部 Node.js 綁定) 為部分實作。process.title 目前在 macOS 和 Linux 上為 no-op。getActiveResourcesInfo、setActiveResourcesInfo、getActiveResources 和 setSourceMapsEnabled 為虛設常式。較新的 API，如 process.loadEnvFile 和 process.getBuiltinModule 尚未實作。