Repository navigation
Verificación de compatibilidad con Node con pruebas que la respaldan
(docs/09-testing/07-compatibilidad-node.md). Es una minor y no un parche
porque añade infraestructura de verificación en CI, un gate de release y cambios
de comportamiento visibles.
Added
- Suite diferencial node vs 3va (
tests/differential/,scripts/differential.sh):
25 escenarios con el mismo script ejecutado connode24 y con3va,
comparando la salida byte a byte, servidor y cliente en procesos distintos y
binarios por SHA-256. Job nuevo enci.yml. - Suite oficial de Node con trinquete (
scripts/setup-node-tests.sh,
crates/test/src/node_tests.rs):test/parallelde nodejs/node v24.22.0
(17 prefijos) con línea base versionada; falla si aparece un fallo nuevo y si
uno arreglado sigue en la línea base. Job endeep-checks.yml. - Escenario del cliente como gate de release (
tests/client-scenario/,
scripts/client-scenario.sh): app Express + sesión + subida/descarga por
SHA-256 +pg/SCRAM + axios + nginx contrustedProxies, con el binario de
release endebian:bookworm-slim. Job nuevo enrelease.ymlque bloquea la
publicación. - Suites de librerías reales (
scripts/library-suites.sh): express 4/5,
body-parser, axios, pg, multer, ws y fastify; resultados de referencia en
tests/library-suites/results.txt. Job de referencia endeep-checks.yml. - Inventario de métodos falsos:
docs/05-js-engine/07-inventario-stubs.md. node:test:require('node:test')ya no devuelve un objeto vacío (test,
describeeiteranundefined). Implementa el subconjunto que usan la
suite oficial de nodejs/node y una suite de proyecto típica:test/it,
describe/suite,before/after/beforeEach/afterEach,t.test()
anidado,{ skip, todo, only }, funcionesasyncy con callbackdone,
t.mock.fn()/t.mock.method()yt.assert. La salida usa el reporter
specde Node (✔ nombre (0.39ms),ℹ tests 5) y el código de salida es
≠ 0 si algo falla;--test-reporter=tapda la salida TAP. Lo que no se
implementa (mock.timers,snapshot,run()) lanzaERR_NOT_SUPPORTED, no
quedaundefined.- Módulos heredados
_http_*y_stream_*:_http_common,_http_server,
_http_agent,_http_client,_http_incoming,_http_outgoing,
_stream_readable,_stream_writable,_stream_duplex,_stream_transform
y_stream_passthrough(deprecados en Node, pero públicos) exponen lo que
3va ya implementa, sin duplicar código.HTTPParserno se expone: 3va no
tiene un equivalente. - Flags de Node en
3va run:--no-warnings,--pending-deprecation,
--expose-gc(y su alias--expose_gc),--zero-fill-bufferse
--insecure-http-parser, más--test-reporterparanode:test.
--tls-min-v1.0se rechaza con un error claro: el TLS de 3va (rustls) tiene
un suelo de TLS 1.2.
Fixed
cluster.fork(): el worker se creía el primario (cluster.isPrimary === true,
congelado en el snapshot de builtins) y no recibía elenv; volvía a forkear
sin fin (bomba de procesos).isPrimary/isWorker/workerson ahora getters
en tiempo de ejecución ycluster.fork(env)propaga el env.child_process.fork(path, args): losargsno llegaban al hijo, así que
un hijo que ramifica porprocess.argv[2]volvía a forkear. Ahora se pasan.http.STATUS_CODES: faltaban entradas (p. ej.415), lo que además
eliminaba el campoerrorde la respuesta 415 de fastify. Tabla completa de Node.- TLS con CA privada: el cliente
https/tlsno leíaNODE_EXTRA_CA_CERTS
(usaba native-tls/OpenSSL, que solo confía en el almacén del SO). Ahora añade
los certificados del bundle como raíces. - La suite diferencial ya no deja servidores huérfanos al terminar.
- El archivo de entrada se ejecuta como módulo CommonJS: antes se evaluaba
como script global. Susconst/letde nivel superior entraban en el ámbito
léxico global, así queconst { setTimeout } = require('timers/promises')en
server.jsdejaba en TDZ elsetTimeoutde todas las dependencias que se
cargaban después; y unreturnde nivel superior era un error de sintaxis.
Ahora la entrada corre dentro del mismo envoltorio que los módulos
requeridos, conrequire.main === module,module.id === '.',
this === module.exports,__filename/__dirnamepropios y las variables de
nivel superior locales al módulo (unvarde la entrada ya no aparece en
globalThis). Las entradas ESM (.mjs,import/export) conservan la
semántica de módulo: allí unreturnde nivel superior sigue siendo un
error de sintaxis. - Las trazas dicen dónde está el error: el archivo y la línea, la línea de
código y el^debajo (como en Node), y cada fotograma de la pila lleva el
archivo y la posición exactos. Antes las trazas no tenían nombre de archivo
y las columnas de la primera línea iban desplazadas. Node compila el archivo
de entrada y cada módulo requerido como una función con los parámetros del
módulo y con el nombre del archivo en elScriptOrigin; 3va deja de
reformatear un.jsal cargarlo, así que las posiciones son las del archivo. process.emitWarningimprime el aviso en stderr
((node:PID) [CÓDIGO] Nombre: mensaje) y entrega el eventowarningen el
siguiente tick, como en Node. Con--no-warningssolo se silencia la
impresión, no el evento.unref()yref()funcionan: eran no-ops en timers, intervalos, servidores
http/nety sockets, así que un proceso que solo conservaba handles con
unref()nunca terminaba. Ahora el bucle de eventos los ignora, como en Node.server.listen(callback)(sin puerto) enhttpynetno llamaba al
callback y dejaba el proceso vivo;net.Server.address()devolvía siempre el
puerto 0 en lugar del puerto real traslisten(0);listen({ reusePort })
activaSO_REUSEPORT(solo si se pide).- Escrituras grandes a un socket: fallaban con
EAGAIN("Resource
temporarily unavailable") cuando superaban el búfer de envío; ahora el resto se
reintenta en el siguiente turno. http, servidor: la respuesta es incremental (write()yflushHeaders()
envían antes deend(), también conContent-Lengthexplícito) y avisa de la
contrapresión; una escritura vacía ya no manda el terminadorchunked;
server.closeIdleConnections()ycloseAllConnections()existen; responde
408cuando venceheadersTimeouto el cuerpo no llega a tiempo (los límites
del cortafuegos no cambian);close()respeta las conexiones con una petición
a medias.http, cliente:abort()/destroy()de peticiones y respuestas con la
semántica de Node ('abort','aborted','close',ECONNRESET),
req.setTimeout()yres.setTimeout()también después de abierto el socket, la
conexión se abre al crear la petición (como en Node) yabort()en el mismo
turno ya no dicesocket hang up.stream:Writableejecuta un_write()a la vez, convierte strings a
Buffer(decodeStrings),setDefaultEncoding()funciona,destroyed
empieza enfalse,EventEmitter#emit('error')sin oyente lanza como en Node, y
StringDecoder('base64')retiene los grupos de 3 bytes incompletos.
fs.createReadStream/createWriteStreamaceptan un string comooptions(el
encoding).
Medido
Compatibilidad con Node medida con test/parallel de nodejs/node v24.22.0
(f14cd3aa), 3va 2.13.0, 2026-10-22: 315/1173/174 → 21,2 %
(pasados/fallados/saltados; los saltados no cuentan; el 2026-10-16 eran
198/1275/189 → 13,4 %). Sustituye al ~97 %
auto-declarado. Detalle por módulo en docs/12-roadmap/04-compatibility.md.
Notes
http/https/net/streamdetest/parallelcuelgan en algunos tests y
dominan el tiempo; por eso corren en el chequeo semanal y no en cada PR.- Diferencia conocida pendiente en la suite diferencial: live bindings en ciclos
ESM. El import relativo de.mjsy el framingchunkedde las escrituras
incrementales dehttp.requestya coinciden con Node. - El siguiente proyecto es usar los streams de Node en lugar de los propios
(docs/12-roadmap/08-vendorizar-streams-de-node.md): la mayoría de los fallos
que quedan en la suite oficial son brechas de base destream, no detalles.
What's Changed
- 2.13.0 — verificación de compatibilidad con Node (suite diferencial, suite oficial, escenario de cliente, suites de librerías) by @OdinoCano in #66
- docs: fold the unreleased entries into the 2.13.0 changelog by @OdinoCano in #68
- fix: Windows release build, and security updates for ctutils and tokio by @OdinoCano in #69
Full Changelog: v2.12.6...v2.13.0