Node.js 26.5.0 è ora disponibile. È una versione Current, non un ramo LTS, quindi si trova all'avanguardia di ciò che

Node.js 26.5.0 è ora disponibile. È una release "Current", non una versione LTS, quindi si colloca sulla frontiera di ciò che la piattaforma può fare. Questa distinzione è importante. Non dovreste implementarla alla cieca in un ambiente di produzione che richiede diciotto mesi di stabilità. Ma è proprio in questi rilasci più piccoli e rapidi che si vede il futuro prendere forma. Mostrano quali API i manutentori stanno perfezionando e verso quale direzione si sta muovendo il runtime. Nella versione 26.5.0, il lavoro principale riguarda la Web Streams API, con una coppia di correzioni mirate che avvicinano Node alla parità con i browser. Il rilascio sistema anche due piccole imperfezioni nei livelli di gestione del file system e degli URL.

Cosa fanno le Web Streams in Node.js?

Se hai scritto codice di streaming in Node per un certo periodo di tempo, saprai che il modulo integrato stream ha una sua personalità. Readable, Writable, Transform e Duplex sono stati i motori dell'ecosistema per anni. Sono potenti, ma non sono uguali agli stream che si incontrano nel browser. Quando cerchi di condividere la logica tra un service worker front-end e un route handler back-end, quel divario crea attrito. Ti ritrovi a riscrivere adapter, copiare dati in formati sconosciuti o semplicemente a evitare del tutto il codice condiviso.

La Web Streams API esiste per colmare questo divario. È lo stesso standard che gestisce il corpo di fetch nel browser. Portandola in Node, il progetto ti permette di scrivere la logica di streaming una sola volta e di eseguirla in entrambi gli ambienti. L'API utilizza oggetti ReadableStream, WritableStream e TransformStream che passano chunk attraverso un'interfaccia uniforme. La versione 26.5.0 non riscrive quell'interfaccia, ma stringe due bulloni importanti.

Correzione di releaseLock e pulizia dei lettori BYOB

Un cambiamento concreto in questo rilascio è la correzione del metodo releaseLock su WritableStreamDefaultWriter. Nel modello Web Streams, un lock dello scrittore impedisce a più consumatori di interferire contemporaneamente con lo stesso stream. Quando chiami releaseLock(), segnali che il tuo scrittore ha terminato e che lo stream sottostante è libero per l'operazione successiva. Un'implementazione errata in questo punto può lasciare uno stream in un limbo, facendogli credere di essere ancora occupato anche se lo scrittore è scomparso. In un server impegnato a analizzare upload o a convogliare dati verso lo storage, quel tipo di lock scaduto può bloccare una pipeline o generare errori difficili da risalire alla loro origine. La correzione nella 26.5.0 rende nuovamente prevedibile il passaggio di consegne.

Il secondo cambiamento relativo alle Web Streams migliora il modo in cui ReadableStream e TransformStream lavorano con i lettori BYOB. BYOB sta per "Bring Your Own Buffer". Invece di far allocare allo stream un nuovo blocco di memoria ogni volta che consegna dati, gli passi un buffer che hai già messo da parte. Lo stream riempie quel buffer, tu elabori i byte e poi restituisci lo stesso buffer per il riutilizzo. È una piccola differenza meccanica che produce risultati straordinari quando si spostano grandi volumi di dati.

Node supporta BYOB da tempo, ma alcuni casi limite in ReadableStream e TransformStream potevano comportarsi in modo anomalo quando veniva collegato un lettore BYOB. I dettagli della correzione contano meno del risultato pratico: gli stream che utilizzano buffer espliciti sono ora più affidabili sia nelle fasi di lettura che di trasformazione. Se hai evitato i lettori BYOB a causa di errori insoliti durante gli eventi di backpressure, questo rilascio rimuove un altro motivo per stare alla larga.

Dove si manifesta effettivamente il BYOB

È facile parlare di riutilizzo dei buffer in astratto. È più utile pensare a dove questo sia rilevante.

Immagina di scrivere un servizio che accetta upload di telemetria. Questi upload potrebbero essere log compressi o dump grezzi di sensori, ciascuno di diverse centinaia di megabyte. Se lo stream alloca un nuovo Buffer di Node per ogni fetta di dati, il garbage collector lavora extra e i picchi di memoria salgono rapidamente. Con un lettore BYOB, allochi un modesto pool di buffer all'avvio. Lo stream li riempie, il tuo parser li svuota e tornano in circolo. La memoria rimane stabile. Lo stesso schema si applica quando si fa da proxy al traffico di rete tra due socket o si analizzano grandi file CSV riga per riga senza caricare tutto in RAM.

Transform streams are equally important here. A TransformStream sits in the middle of a pipeline, perhaps decompressing a gzip stream or encrypting chunks on the fly. If the transform step mishandles BYOB buffers, you can see corrupted output, dropped chunks, or stalls under load. The 26.5.0 fixes address exactly those kinds of pipeline hiccups, which is why anyone running high-throughput I/O should pay attention.

The Quiet Wins: File System and Error Clarity

Not everything in 26.5.0 is about streaming. The release also fixes behavior in fs.rm and fs.rmSync when the recursive option is set to false. Previously, passing recursive: false alongside a directory path could produce unexpected results during cleanup. The method might act in ways that did not match the explicit intent of the caller, deleting more than expected or failing in inconsistent ways depending on the platform. Cleaning up files is the sort of operation that should be boring and predictable. Boring is good. This fix restores that predictability, so your temporary directory cleanup scripts or deployment teardown logic behave exactly as the code suggests.

There is also a quality-of-life improvement in how URL.canParse reports failure. The method checks whether a string is a valid URL without throwing on malformed input. In 26.5.0, it now carries better Error.cause information when something goes wrong. Rather than swallowing the original reason, the error object preserves a causal chain. That means when a URL parse fails deep inside a validation helper, the stack you log tells you whether the issue was a bad protocol, a missing hostname, or some other structural problem. You spend less time sprinkling manual debug logs across every call site.

Should You Upgrade?

The answer depends on what you are running.

If your production workloads sit on an LTS version such as the v20.x line, stay there. These fixes will eventually backport or arrive in the next active LTS. Stability and predictable support timelines outweigh the benefit of a slightly smoother stream lock or clearer URL error on a server that is already working.

If you are building a new service, prototyping a real-time data pipeline, or actively using the Web Streams API for performance-critical I/O, 26.5.0 is worth the jump. The incremental alignment between Node streams and browser Web Streams is not just a compatibility win. It is a bet on a more unified JavaScript runtime where the same data-pushing logic can travel between server and client without translation layers. That cuts down on cognitive load and reduces the surface area for bugs when your team ships code to both environments.

This release is small, but the direction is clear. Node is continuing to invest in standards-based APIs that work everywhere JavaScript runs. The Web Streams improvements are not headline features, but they smooth out a path that has been rocky for years. Grab 26.5.0 if you live on the Current line, and watch for these fixes to land in your LTS world when the time is right.

Source: Dev.to – Node.js 26.5.0: What's New for Web Streams and Error Handling

Join the discussion and keep learning with the GyaanSetu community on Telegram.