René's URL Explorer Experiment

Title: net: add experimental net/promises API by Ethan-Arrowood · Pull Request #63965 · nodejs/node · GitHub

Open Graph Title: net: add experimental net/promises API by Ethan-Arrowood · Pull Request #63965 · nodejs/node

X Title: net: add experimental net/promises API by Ethan-Arrowood · Pull Request #63965 · nodejs/node

Description: Adds an experimental net/promises namespace that provides promise-based variants of net's connection and listening operations, mirroring the existing fs/promises and dns/promises modules. It is accessible via require('node:net/promises') or require('node:net').promises. Motivation net has no promise-based API. To await a connected socket or a listening server today you have to hand-wire the 'connect'/'listening' and 'error' events into a new Promise, or reach for events.once. There is long-standing demand for a first-class promise API for these one-shot lifecycle moments (Refs: #21482). net is stream- and event-oriented, so only its one-shot async moments map cleanly to promises (establishing a connection and binding a server). The rest of the api remains the same. What's added netPromises.connect(options) / connect(path) / connect(port[, host]) — resolves with a connected net.Socket once its 'connect' event fires; rejects on connection failure or abort, destroying the socket. netPromises.listen([options]) — creates a server, begins listening, and resolves with the listening net.Server once its 'listening' event fires; rejects if it fails to bind or is aborted before listening, closing the server. Accepts a connectionListener option and the usual net.createServer / server.listen options. The signal aborts the server for its entire lifetime (aborting after it is listening closes it), matching net.Server's own signal behavior. net.Server is now async iterable: for await (const socket of server) yields each incoming connection, as an alternative to the 'connection' event (mirrors readline.Interface). Connections buffer if the consumer is slow; server.maxConnections bounds concurrency. The synchronous helpers (isIP, isIPv4, isIPv6, BlockList, SocketAddress) are re-exported for convenience. Both functions accept an optional AbortSignal and reject with an AbortError when it is aborted, consistent with timers/promises and readline/promises. Example: import { connect, listen } from 'node:net/promises'; const server = await listen({ port: 0 }); const socket = await connect({ port: server.address().port }); // Consume incoming connections as an async iterator: for await (const conn of server) { conn.end('hello world!'); } A note on naming (connect/listen, not createConnection/createServer) The naming here is intentional. This API promisifies actions that complete: connect() resolves once the connection is established, and listen() resolves once the server is listening. The function name is the action being awaited, and the two form a parallel pair. That is deliberately not the factory taxonomy of the callback API. There, createConnection() is the canonical name because it both creates a socket and initiates connecting. Creation and the action are fused, so the factory name also implies the action. createServer(), by contrast, is a pure factory: it does not listen; listening is the separate server.listen() step. So a createConnection/createServer pairing would be inconsistent in a promise API. createServer has no completion to await. Naming the functions for their actions (connect/listen) keeps the pair coherent, and there is no factory counterpart to alias, so createConnection is intentionally omitted. Notes New experimental API (Stability: 1). semver-minor. Implemented on top of events.once(emitter, name, { signal }), so error and abort handling match the rest of core. Documentation and tests included. Refs: #21482 Assisted-by: Claude Opus 4.8 noreply@anthropic.com

Open Graph Description: Adds an experimental net/promises namespace that provides promise-based variants of net's connection and listening operations, mirroring the existing fs/promises and dns/promises modules. It is...

X Description: Adds an experimental net/promises namespace that provides promise-based variants of net's connection and listening operations, mirroring the existing fs/promises and dns/promises modules. I...

Opengraph URL: https://github.com/nodejs/node/pull/63965

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width