Документация по функциям обратного вызова в NodeJS, особенно net .createServer

Question

В документации NodeJS написано, что net.createServer имеет необязательный аргумент connectionListener

net.createServer([options][, connectionListener])

В документации не сказано, что у него есть аргумент, сокет входящего соединения , получается только из примера кода:

const net = require('net');
const server = net.createServer((c) => {
  // 'connection' listener
  console.log('client connected');
  c.on('end', () => {
    console.log('client disconnected');
  });
  c.write('hello\r\n');
  c.pipe(c);
});
server.on('error', (err) => {
  throw err;
});
server.listen(8124, () => {
  console.log('server bound');
});

Где это описано в документации NodeJS, есть ли у функции обратного вызова какие-либо аргументы и что это такое?

Answer 1

Он задокументирован как параметр, передаваемый в событие 'connection':

• connectionListener Автоматически устанавливается в качестве прослушивателя для соединения ' ' событие.

И если вы проверите, что такое событие connection , вы получите следующее:

Событие:' connection '

Добавлено в: v0.1.90

• <net.Socket> Объект подключения

Издается при создании нового соединения. сокет является экземпляром net .Socket.

Таким образом, параметр, переданный функции, которая обрабатывает событие connection , представляет собой net .Socket объект.