Change8

v0.27.0

Breaking Changes
📦 esbuild
2 breaking1 features🔧 2 symbols

Summary

This release updates the Go compiler to v1.25.4, raising minimum OS requirements for Linux and macOS, and optimizes the 'binary' loader to use native base64 decoding.

⚠️ Breaking Changes

  • Increased minimum operating system requirements due to Go compiler update: Linux now requires kernel 3.2+, and macOS now requires macOS 12 (Monterey) or later.
  • The 'binary' loader now defaults to using 'Uint8Array.fromBase64' in environments where it is available, which may require explicit 'target' configuration (e.g., --target=node22) for Node.js environments below v25.

Migration Steps

  1. Pin the exact version of esbuild in package.json or use a patch-only version range (e.g., ^0.26.0) to avoid breaking changes.
  2. Ensure build environments meet the new OS requirements: Linux kernel 3.2+ or macOS 12+.
  3. Specify a 'target' (e.g., --target=node22) if using the 'binary' loader in Node.js versions between v22 and v24 to ensure compatibility with base64 decoding.

✨ New Features

  • The 'binary' loader now utilizes the native 'Uint8Array.fromBase64' API when supported by the target environment for improved performance.

🔧 Affected Symbols

Uint8Array.fromBase64binary loader