Bun v0.1.11

[Jarred-Sumner]

To upgrade:

bun upgrade

To install:

curl https://bun.sh/install | bash

If you have any problems upgrading

Run the install script (you can run it multiple times):

curl https://bun.sh/install | bash

In Bun v0.1.11, web framework libraries built on Bun got faster

Benchmark: https://github.com/SaltyAom/bun-http-framework-benchmark
Image credit: @Kapsonfire-DE

Plugin API

Bun's runtime now supports a plugin API.

• import and require .svelte, .vue, .yaml, .scss, .less and other file extensions that Bun doesn't implement a builtin loader for
• Dynamically generate ESM & CJS modules

The API is loosely based on esbuild's plugin API.

This code snippet lets you import .mdx files in Bun:

import { plugin } from "bun";
import { renderToStaticMarkup } from "react-dom/server";

// Their esbuild plugin runs in Bun (without esbuild)
import mdx from "@mdx-js/esbuild";
plugin(mdx());

// Usage
import Foo from "./bar.mdx";
console.log(renderToStaticMarkup(<Foo />));

This lets you import yaml files:

import { plugin } from "bun";

plugin({
  name: "YAML",

  setup(builder) {
    const { load } = require("js-yaml");
    const { readFileSync } = require("fs");
    // Run this function on any import that ends with .yaml or .yml
    builder.onLoad({ filter: /\.(yaml|yml)$/ }, (args) => {
      // Read the YAML file from disk
      const text = readFileSync(args.path, "utf8");

      // parse the YAML file with js-yaml
      const exports = load(text);

      return {
        // Copy the keys and values from the parsed YAML file into the ESM module namespace object
        exports,

        // we're returning an object
        loader: "object",
      };
    });
  },
});

We're planning on supporting browser builds with this plugin API as well (run at transpilation time)

Reliability improvements

Node compatibility:

• feat: implement native os module by @xhyrom in feat: implement native os module #1115
• fix buffer.copy by @zhuzilin in fix buffer.copy #1113
• fix buffer.slice(0, 0) by @zhuzilin in fix buffer.slice(0, 0) #1114
• Add buffer.indexOf, includes and lastIndexOf by @zhuzilin in Add buffer.indexOf, includes and lastIndexOf #1112
• Add native EventEmitter by @zhuzilin in Add native EventEmitter #1123
• Support emit Symbol events in EventEmitter by @zhuzilin in Support emit Symbol events in EventEmitter #1129
• add SlowBuffer by @zhuzilin in add SlowBuffer #1133
• update minified url polyfill by @samfundev in update minified url polyfill #1132
• Add pad back to base64 by @zhuzilin in Add pad back to base64 #1140
• fix mkdtemp by @zhuzilin in fix mkdtemp #1151
• Fix Buffer.isEncoding 39dc989
• Implement napi_add_finalizer f023b89
• NAPI_MODULE_INIT() wasn't implemented correctly in Bun and that has been fixed
• import assert and import process did not behave as expected (assert wasn't returning a function). This has been fixed
• "node:module"'s createRequire function wasn't requiring non-napi modules correctly

macOS event loop internals moved to a more reliable polling mechanism:

• setTimeout CPU usage drops by 50% c1734c6 (Before: 90%, After: 33% - still more work to do here)
• on macOS, bun would sometimes hang due to race conditions (unrelated to network connection) if you ran fetch enough times in quick succession. The race conditions have been fixed.

More:

• [bun:ffi] Fix crash with uint64_t 296fb41
• [bun:ffi] Fix int16 / uin16 max 30992a8
• Fix Request and Response in macros e0b35b3
• Fix clearTimeout on Linux e6a1209

Performance improvements

Bun has a long-term commitment to performance. On macOS, React server-side rendering gets around 2x faster.

Coming up next in performance improvements: a new HTTP server implementation. Not far enough along for this release, but experiments are showing progress.

More PRs

• fix(ReferenceError): expected type in getCode by @xhyrom in fix(ReferenceError): expected type in getCode #1120
• chore: fix bun-tools location in macOSx Zig instructions by @mljlynch in chore: fix bun-tools location in macOSx Zig instructions #1124
• Fix clearTimeout and linux timeout by @zhuzilin in Fix clearTimeout and linux timeout #1138
• Add native BufferList by @zhuzilin in Add native BufferList #1146
• fix: broken README links by @MNThomson in fix: broken README links #1148
• fix: added shell function to STRIP by @dylan-conway in fix: added shell function to STRIP #1156
• fix compile error by @zhuzilin in fix compile error #1157
• Fix ffi uint64_t parameter by @zhuzilin in Fix ffi uint64_t parameter #1158
• Update WebKit by @Jarred-Sumner in Update WebKit #1165
• Support for NULL in ffi by @zhuzilin in Support for NULL in ffi #1160
• feat: hack in support for tsconfig extends by @yepitschunked in feat: hack in support for tsconfig extends #1147
• More reliable macOS event loop by @Jarred-Sumner in More reliable macOS event loop #1166
• chore: Clean buffer C API by @zhuzilin in chore: Clean buffer C API #1174
• Fixed JSBuffer write issues by @nullhook in Fixed JSBuffer write issues #1175
• Add profiler support by @bwasti in Add profiler support #1110
• chore(doc): remove recurse flag from xattr by @jbergstroem in chore(doc): remove recurse flag from xattr #1182
• Fix typo in futex.zig by @eltociear in Fix typo in futex.zig #1186
• Add native StringDecoder by @zhuzilin in Add native StringDecoder #1188
• Fix failing Buffer tests by @zhuzilin in Fix failing Buffer tests #1197
• allow set proxy for github by @usrtax in allow set proxy for github #1198
• export syntax error fix for exported enums and namespaces by @dylan-conway in export syntax error fix for exported enums and namespaces #1203
• Plugin API by @Jarred-Sumner in Plugin API #1199
• fix: GitHub CLI installation by @Kit-p in fix: GitHub CLI installation #1204
• chore(install-script): automatically add bun to path - bash shell by @xhyrom in chore(install-script): automatically add bun to path - bash shell #1168
• update example react-is to v18(Could not resolve: "react-is". Maybe you need to "bun install"? #1155) by @tHyt-lab in update example react-is to v18(#1155) #1172
• Add native ReadableState by @zhuzilin in Add native ReadableState #1210

New Contributors

• @mljlynch made their first contribution in chore: fix bun-tools location in macOSx Zig instructions #1124
• @samfundev made their first contribution in update minified url polyfill #1132
• @MNThomson made their first contribution in fix: broken README links #1148
• @dylan-conway made their first contribution in fix: added shell function to STRIP #1156
• @yepitschunked made their first contribution in feat: hack in support for tsconfig extends #1147
• @nullhook made their first contribution in Fixed JSBuffer write issues #1175
• @bwasti made their first contribution in Add profiler support #1110
• @jbergstroem made their first contribution in chore(doc): remove recurse flag from xattr #1182
• @usrtax made their first contribution in allow set proxy for github #1198
• @Kit-p made their first contribution in fix: GitHub CLI installation #1204
• @tHyt-lab made their first contribution in update example react-is to v18(#1155) #1172

Full Changelog: bun-v0.1.10...bun-v0.1.11

---

This discussion was created from the release Bun v0.1.11.