examples/net-promises.mjs

GitHub
// @node-skills {"added":["v27.0.0"]}
// node:net/promises — listen()/connect() return promises; a server is async-iterable over connections.
import assert from 'node:assert/strict';
import net from 'node:net';
import { connect, listen } from 'node:net/promises';

assert.equal(net.promises.connect, connect); // also reachable as require('node:net').promises

const server = await listen({ port: 0, host: '127.0.0.1' }); // resolves on 'listening'
const { port } = server.address();

const accepted = (async () => {
  const seen = [];
  for await (const socket of server) {          // ends when the server emits 'close'
    socket.end(`hello ${seen.length}`);          // don't await long work inline: it serializes accepts
    seen.push(socket.remoteAddress);
    if (seen.length === 2) server.close();
  }
  return seen;
})();

for (let i = 0; i < 2; i++) {
  const sock = await connect({ port, host: '127.0.0.1' }); // resolves on 'connect'
  let data = '';
  for await (const chunk of sock) data += chunk;
  assert.equal(data, `hello ${i}`);
}
assert.deepEqual(await accepted, ['127.0.0.1', '127.0.0.1']);

// Rejections: refused connection, and an aborted connect (the socket is destroyed).
await assert.rejects(connect({ port, host: '127.0.0.1' }), { code: 'ECONNREFUSED' });
await assert.rejects(connect({ port, host: '127.0.0.1', signal: AbortSignal.abort() }), { name: 'AbortError' });
// listen() rejects if the bind fails.
const busy = await listen({ port: 0, host: '127.0.0.1' });
await assert.rejects(listen({ port: busy.address().port, host: '127.0.0.1' }), { code: 'EADDRINUSE' });
busy.close();