bun.sh/docs/runtime/nodejs-apis.md at e9db9f32b14dc76d6a8e7dffab83d51ec4cf5713

mirror of https://github.com/oven-sh/bun synced 2026-02-10 10:58:56 +00:00

Files

dave caruso 57a06745a4 Progress for Next.js (#4468 )

* L

* ipc

* asdfghjkl

* dfghjk

* it works!

* types

* patches for next.js

* sdfghj

* wsdfgn,./

* this

* yolo

* okay loser

* asdfghjk

* add some more APIs

* MESS

* sdfghjkl

* remove native events from streams

* stuff

* remove lazy(primordials) test

* debugging

* okay

* less fake extensions object

* fix `Buffer.toString()` args logic

* fix deserialize

* make tests work

* add test for `Buffer.toString` args

* Update server.zig

* remove test

* update test

* Update spawn-streaming-stdin.test.ts

* fix linux build

* Update fs.test.ts

* cli message improvements

* dfshaj

* Fix fs.watch bug maybe?

* remove

---------

Co-authored-by: Dylan Conway <dylan.conway567@gmail.com>

2023-09-07 04:58:44 -07:00

33 KiB

Raw Blame History

Bun aims for complete Node.js API compatibility. Most npm packages intended for Node.js environments will work with Bun out of the box; the best way to know for certain is to try it.

This page is updated regularly to reflect compatibility status of the latest version of Bun. If you run into any bugs with a particular package, please open an issue. Opening issues for compatibility bugs helps us prioritize what to work on next.

Built-in modules

`node:assert`

🟢 Fully implemented.

`node:async_hooks`

🟡 Only AsyncLocalStorage, and AsyncResource are implemented.

`node:buffer`

🟢 Fully implemented.

`node:child_process`

🟡 Missing Stream stdio, proc.gid, proc.uid. IPC has partial support and only current only works with other bun processes.

`node:cluster`

🔴 Not implemented.

`node:console`

🟡 Missing Console constructor.

`node:crypto`

🟡 Missing crypto.Certificate crypto.ECDH crypto.KeyObject crypto.X509Certificate crypto.checkPrime{Sync} crypto.createPrivateKey crypto.createPublicKey crypto.createSecretKey crypto.diffieHellman crypto.generateKey{Sync} crypto.generateKeyPair{Sync} crypto.generatePrime{Sync} crypto.getCipherInfo crypto.{get|set}Fips crypto.hkdf crypto.hkdfSync crypto.secureHeapUsed crypto.setEngine crypto.sign crypto.verify. Some methods are not optimized yet.

`node:dgram`

🔴 Not implemented.

`node:diagnostics_channel`

🟢 Fully implemented.

`node:dns`

🟢 Fully implemented.

`node:domain`

🟢 Fully implemented.

`node:events`

🟡 Missing on

`node:fs`

🟡 Missing fs.fdatasync{Sync} fs.opendir{Sync}. fs.promises.open incorrectly returns a file descriptor instead of a FileHandle.

`node:http`

🟢 Fully implemented.

`node:http2`

🔴 Not implemented.

`node:https`

🟢 Fully implemented.

`node:inspector`

🔴 Not implemented.

`node:module`

🟢 Fully implemented.

`node:net`

🟡 Missing net.{get|set}DefaultAutoSelectFamily net.SocketAddress net.BlockList.

`node:os`

🟢 Fully implemented.

`node:path`

🟢 Fully implemented.

`node:perf_hooks`

🟡 Only perf_hooks.performance.now() and perf_hooks.performance.timeOrigin are implemented. Recommended to use performance global instead of perf_hooks.performance.

`node:process`

🟡 See Globals > process.

`node:punycode`

🟢 Fully implemented. Deprecated by Node.js.

`node:querystring`

🟢 Fully implemented.

`node:readline`

🟢 Fully implemented.

`node:repl`

🔴 Not implemented.

`node:stream`

🟢 Fully implemented.

`node:string_decoder`

🟢 Fully implemented.

`node:sys`

🟡 See node:util.

`node:timers`

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

`node:tls`

🟡 Missing tls.createSecurePair

`node:trace_events`

🔴 Not implemented.

`node:tty`

🟢 Fully implemented.

`node:url`

🟡 Missing url.domainTo{ASCII|Unicode}. Recommended to use URL and URLSearchParams globals instead.

`node:util`

🟡 Missing util.MIMEParams util.MIMEType util.getSystemErrorMap() util.getSystemErrorName() util.parseArgs() util.stripVTControlCharacters() util.transferableAbortController() util.transferableAbortSignal().

`node:v8`

🔴 serialize and deserialize use JavaScriptCore's wire format instead of V8's. Otherwise, not implemented. For profiling, use bun:jsc instead.

`node:vm`

🟡 Core functionality works, but VM modules are not implemented. ShadowRealm can be used.

`node:wasi`

🟡 Partially implemented.

`node:worker_threads`

🟡 Worker doesn't support the following options: eval, argv, execArgv, stdin, stdout, stderr, trackedUnmanagedFds, resourceLimits. Missing markAsUntransferable, moveMessagePortToContext, getHeapSnapshot.

`node:zlib`

🟡 Missing zlib.brotli*. Has not been optimized.

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`

🟡 Incomplete implementation of base64 and base64url encodings.

`ByteLengthQueuingStrategy`

🟢 Fully implemented.

`__dirname`

🟢 Fully implemented.

`__filename`

🟢 Fully implemented.

`atob()`

🟢 Fully implemented.

`BroadcastChannel`

🟢 Fully implemented.

`btoa()`

🟢 Fully implemented.

`clearImmediate()`

🟢 Fully implemented.

`clearInterval()`

🟢 Fully implemented.

`clearTimeout()`

🟢 Fully implemented.

`CompressionStream`

🔴 Not implemented.

`console`

🟡 Missing Console constructor.

`CountQueuingStrategy`

🟢 Fully implemented.

`Crypto`

🟢 Fully implemented.

`SubtleCrypto (crypto)`

🟢 Fully implemented.

`CryptoKey`

🟢 Fully implemented.

`CustomEvent`

🟢 Fully implemented.

`DecompressionStream`

🔴 Not implemented.

`Event`

🟢 Fully implemented.

`EventTarget`

🟢 Fully implemented.

`exports`

🟢 Fully implemented.

`fetch`

🟢 Fully implemented.

`FormData`

🟢 Fully implemented. Added in Bun 0.5.7.

`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`

🔴 Not implemented.

`PerformanceMark`

🔴 Not implemented.

`PerformanceMeasure`

🔴 Not implemented.

`PerformanceObserver`

🔴 Not implemented.

`PerformanceObserverEntryList`

🔴 Not implemented.

`PerformanceResourceTiming`

🔴 Not implemented.

`performance`

🟢 Fully implemented.

`process`

🟡 Missing process.allowedNodeEnvironmentFlags process.channel process.constrainedMemory() process.getActiveResourcesInfo/setActiveResourcesInfo() process.setuid/setgid/setegid/seteuid/setgroups() process.hasUncaughtExceptionCaptureCallback process.initGroups() process.report process.resourceUsage().

33 KiB Raw Blame History

Built-in modules

Globals

33 KiB

Raw Blame History