10 years of uWS

If you are interested, there is a more detailed retrospect release post in the main repo. For Node.js we have the following changes:

• getRemoteAddress(), getRemoteAddressAsText() calls are now zero cost. This is a major performance boost for apps using these in hot paths.
• onDataV2 is a superior alternative to onData, explained in the linked retrospect release.
• collectBody is a helper function making optimal use of the new onDataV2. It allows efficient and easy collection of smallish HTTP posts into RAM, returned as one whole buffer.
• We now build AddressSanitizer binaries, available in branch binaries-asan. These can be very useful for debugging or filing bug reports related to crashes and segfaults. To run the ASAN binaries, your Node.js invocation needs to be prefixed with LD_PRELOAD like so: LD_PRELOAD=$(gcc -print-file-name=libasan.so) node server.js
• DeclarativeResponse can now do writeStatus as well as end with binary, not just text.
• Many documentation fixes.
• Support for symbol-keyed properties in WebSocket UserData.
• getRemotePort, getProxiedRemotePort.

Bump lsquic

The experimental HTTP3 support is now building on latest lsquic 4.6.0.

Following new BoringSSL versions

BoringSSL has deprecated their chromium-stable branch in favor of "date tagging". This version builds the recent 0.20260211.0 date tag.

Easier URL route debugging

Whenever a URL route isn't handled properly, we used to display a fatal error and terminate the process like so:

Error: Returning from a request handler without responding or attaching an abort handler is forbidden!

This was not an issue in C++ since you could easily catch what route is broken by using a debugger. This is not possible in JavaScript since you aren't debugging the C++ code, only the JS code and the error isn't coming from JS.

A simple ergonomical upgrade is to display method & URL as part of the error:

Error: Returning from a request handler without responding or attaching an abort handler is forbidden!
        Method: "GET"
        URL: "/this_url_is_unhandled_test"
terminate called without an active exception

• Fixes a bug in uWS.getParts where returned parts were previously zero-copy references into the given buffer. These parts are now copies, eliminating potential complex memory issues which shouldn't have been be exposed to script. uWS.getParts is not a streaming parser unlike most of uWS, so I would still caution against using it (even though it is faster than all other such parsers for Node.js given small files).

Streamlined cross-platform build & test

• All platforms (even Windows 😮 ) & all architectures now build using Clang, have the same build flow (build.yml) and smoke testing.
• Windows no longer requires any MSVCRT.dll, making it more portable.
• Binaries won't be updated without a passed smoke test (they run before upload now).

The entire build.yml is 42 lines now

Massively improved Linux ARM64 builds

• Moving from QEMU emulation to GitHub's native ARM64 runners, we cut building times from 55 minutes to 5 minutes
• The same building flow and smoke testing is now shared for macOS, Linux x64 and Linux ARM64
• Build "scripts" are now less than 300 lines in total for the entire project across all platforms, versions and architectures

Raise macOS target version to 15

• Fixes newly added Node.js 25 support on macOS.
• Removes old Linux 32-bit ARM stale binaries.

Node.js 25

• Adds Node.js 25 support, removes Node.js 23
• Raises Linux target platform to Ubuntu 24.04
• 32-bit Linux ARM binaries haven't been built for this release, or the prior one and will probably be removed as a target in favor of 64-bit Linux ARM only.

Node.js 24

• Bumps uWS to v20.74.0 + latest commits
• Add Node.js 24, removes Node.js 18
• Raises Linux target platform to Ubuntu 22.04