v0.27.0
Breaking Changes📦 esbuild
⚠ 2 breaking✨ 1 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
- 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.
- Ensure build environments meet the new OS requirements: Linux kernel 3.2+ or macOS 12+.
- 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