How do I install the Bun Node.js Compatibility skill?

Run npx skillmds@latest add jarle/bun-node-js-compatibility in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Bun Node.js Compatibility skill do?

Bun's compatibility status with Node.js APIs, modules, and globals It is listed under Coding & Dev Tools on SkillMD.

Is Bun Node.js Compatibility safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bun Node.js Compatibility?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bun Node.js Compatibility free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bun Node.js Compatibility?

jarle (@jarle) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bun Node.js Compatibility by jarle — Agent Skill

Name: Bun Node.js Compatibility
Rating: 4.2 (5 reviews)
Author: jarle

Node.js Compatibility

Bun's compatibility status with Node.js APIs, modules, and globals

Every day, Bun gets closer to 100% Node.js API compatibility. Today, popular frameworks like Next.js, Express, and millions of npm packages intended for Node just work with Bun. To ensure compatibility, we run thousands of tests from Node.js' test suite before every release of Bun.

If a package works in Node.js but doesn't work in Bun, we consider it a bug in Bun. Please open an issue and we'll fix it.

This page is updated regularly to reflect compatibility status of the latest version of Bun. The information below reflects Bun's compatibility with Node.js v23.

Built-in Node.js modules

`node:assert`

🟢 Fully implemented.

`node:buffer`

🟢 Fully implemented.

`node:console`

🟢 Fully implemented.

`node:dgram`

🟢 Fully implemented. > 90% of Node.js's test suite passes.

`node:diagnostics_channel`

🟢 Fully implemented.

`node:dns`

🟢 Fully implemented. > 90% of Node.js's test suite passes.

`node:events`

🟢 Fully implemented. 100% of Node.js's test suite passes. EventEmitterAsyncResource uses AsyncResource underneath.

`node:fs`

🟢 Fully implemented. 92% of Node.js's test suite passes.

`node:http`

🟢 Fully implemented. Outgoing client request body is currently buffered instead of streamed.

`node:https`

🟢 APIs are implemented, but Agent is not always used yet.

`node:os`

🟢 Fully implemented. 100% of Node.js's test suite passes.

`node:path`

🟢 Fully implemented. 100% of Node.js's test suite passes.

`node:punycode`

🟢 Fully implemented. 100% of Node.js's test suite passes, deprecated by Node.js.

`node:querystring`

🟢 Fully implemented. 100% of Node.js's test suite passes.

`node:readline`

🟢 Fully implemented.

`node:stream`

🟢 Fully implemented.

`node:string_decoder`

🟢 Fully implemented. 100% of Node.js's test suite passes.

`node:timers`

🟢 Recommended to use global setTimeout, et. al. instead.

`node:tty`

🟢 Fully implemented.

`node:url`

🟢 Fully implemented.

`node:zlib`

🟢 Fully implemented. 98% of Node.js's test suite passes.

`node:async_hooks`

🟡 AsyncLocalStorage, and AsyncResource are implemented. v8 promise hooks are not called, and its usage is strongly discouraged.

`node:child_process`

🟡 Missing proc.gid proc.uid. Stream class not exported. IPC cannot send socket handles. Node.js ↔ Bun IPC can be used with JSON serialization.

`node:cluster`

🟡 Handles and file descriptors cannot be passed between workers, which means load-balancing HTTP requests across processes is only supported on Linux at this time (via SO_REUSEPORT). Otherwise, implemented but not battle-tested.

`node:crypto`

🟡 Missing secureHeapUsed setEngine setFips

`node:domain`

🟡 Missing Domain active

`node:http2`

🟡 Client & server are implemented (95.25% of gRPC's test suite passes). Missing options.allowHTTP1, options.enableConnectProtocol, ALTSVC extension, and http2stream.pushStream.

`node:module`

🟡 Missing syncBuiltinESMExports, Module#load(). Overriding require.cache is supported for ESM & CJS modules. module._extensions, module._pathCache, module._cache are no-ops. module.register is not implemented and we recommend using a Bun.plugin in the meantime.

`node:net`

🟢 Fully implemented.

`node:perf_hooks`

🟡 APIs are implemented, but Node.js test suite does not pass yet for this module.

`node:process`

🟡 See process Global.

`node:sys`

🟡 See node:util.

`node:tls`

🟡 Missing tls.createSecurePair.

`node:util`

🟡 Missing getCallSite getCallSites getSystemErrorMap getSystemErrorMessage transferableAbortSignal transferableAbortController

`node:v8`

🟡 writeHeapSnapshot and getHeapSnapshot are implemented. serialize and deserialize use JavaScriptCore's wire format instead of V8's. Other methods are not implemented. For profiling, use bun:jsc instead.

`node:vm`

🟡 Core functionality and ES modules are implemented, including vm.Script, vm.createContext, vm.runInContext, vm.runInNewContext, vm.runInThisContext, vm.compileFunction, vm.isContext, vm.Module, vm.SourceTextModule, vm.SyntheticModule, and importModuleDynamically support. Options like timeout and breakOnSigint are fully supported. Missing vm.measureMemory and some cachedData functionality.

`node:wasi`

🟡 Partially implemented.

`node:worker_threads`

🟡 Worker doesn't support the following options: stdin stdout stderr trackedUnmanagedFds resourceLimits. Missing markAsUntransferable moveMessagePortToContext.

`node:inspector`

🟡 Partially implemented. Profiler API is supported (Profiler.enable, Profiler.disable, Profiler.start, Profiler.stop, Profiler.setSamplingInterval). Other inspector APIs are not yet implemented.

`node:repl`

🔴 Not implemented.

`node:sqlite`

🔴 Not implemented.

`node:test`

🟡 Partly implemented. Missing mocks, snapshots, timers. Use bun:test instead.

`node:trace_events`

🔴 Not implemented.

Node.js globals

The table below lists all globals implemented by Node.js and Bun's current compatibility status.

`AbortController`

🟢 Fully implemented.

`AbortSignal`

🟢 Fully implemented.

`Blob`

🟢 Fully implemented.

`Buffer`

🟢 Fully implemented.

`ByteLengthQueuingStrategy`

🟢 Fully implemented.

`__dirname`

🟢 Fully implemented.

`__filename`

🟢 Fully implemented.

`atob()`

🟢 Fully implemented.

`Atomics`

🟢 Fully implemented.

`BroadcastChannel`

🟢 Fully implemented.

`btoa()`

🟢 Fully implemented.

`clearImmediate()`

🟢 Fully implemented.

`clearInterval()`

🟢 Fully implemented.

`clearTimeout()`

🟢 Fully implemented.

`CompressionStream`

🟢 Fully implemented.

`console`

🟢 Fully implemented.

`CountQueuingStrategy`

🟢 Fully implemented.

`Crypto`

🟢 Fully implemented.

`SubtleCrypto (crypto)`

🟢 Fully implemented.

`CryptoKey`

🟢 Fully implemented.

`CustomEvent`

🟢 Fully implemented.

`DecompressionStream`

🟢 Fully implemented.

`Event`

🟢 Fully implemented.

`EventTarget`

🟢 Fully implemented.

`exports`

🟢 Fully implemented.

`fetch`

🟢 Fully implemented.

`FormData`

🟢 Fully implemented.

`global`

🟢 Implemented. This is an object containing all objects in the global namespace. It's rarely referenced directly, as its contents are available without an additional prefix, e.g. __dirname instead of global.__dirname.

`globalThis`

🟢 Aliases to global.

`Headers`

🟢 Fully implemented.

`MessageChannel`

🟢 Fully implemented.

`MessageEvent`

🟢 Fully implemented.

`MessagePort`

🟢 Fully implemented.

`module`

🟢 Fully implemented.

`PerformanceEntry`

🟢 Fully implemented.

`PerformanceMark`

🟢 Fully implemented.

`PerformanceMeasure`

🟢 Fully implemented.

`PerformanceObserver`

🟢 Fully implemented.

`PerformanceObserverEntryList`

🟢 Fully implemented.

`PerformanceResourceTiming`

🟢 Fully implemented.

`performance`

🟢 Fully implemented.

`process`

🟡 Mostly implemented. process.binding (internal Node.js bindings some packages rely on) is partially implemented. process.title is currently a no-op on macOS & Linux. getActiveResourcesInfo setActiveResourcesInfo, getActiveResources and setSourceMapsEnabled are stubs. Newer APIs like process.loadEnvFile and process.getBuiltinModule are not implemented yet.

Bun Node.js Compatibility

File contents

Node.js Compatibility

Built-in Node.js modules

Node.js globals

Related skills

Frequently asked questions

How do I install the Bun Node.js Compatibility skill?

What does the Bun Node.js Compatibility skill do?

Is Bun Node.js Compatibility safe to use?

Which AI agents work with Bun Node.js Compatibility?

Is Bun Node.js Compatibility free to use?

Who published Bun Node.js Compatibility?