Node.js request.socket 属性

在 Node.js 中， request.socket 属性是用于返回 HTTP 请求所使用的底层的 Socket 对象。 在 HTTP 请求过程中，请求头和请求体在 Socket 对象中进行读取和写入。

语法

request.socket

返回值

返回 HTTP 请求所使用的底层的 Socket 对象。

示例

以下是一个简单的使用 request.socket 属性的示例：

const http = require('http');

const server = http.createServer(function (req, res) {
  console.log(req.socket);
});

server.listen(3000);

在控制台输出中，可以看到 request.socket 返回的 Socket 对象，如下所示：

Socket {
  connecting: false,
  _hadError: false,
  _handle: TCP {
    [Symbol(owner)]: [Circular],
    [Symbol(handle)]: TCP,
    [Symbol(asyncId)]: 9,
    [Symbol(lastWriteQueueSize)]: 0,
    [Symbol(timeout)]: null,
    [Symbol(kBytesRead)]: 0,
    [Symbol(kBytesWritten)]: 0,
    [Symbol(kConnections)]: 1
  },
  _parent: null,
  _host: null,
  _readableState: ReadableState {
    objectMode: false,
    highWaterMark: 16384,
    buffer: BufferList { head: null, tail: null, length: 0 },
    length: 0,
    pipes: null,
    pipesCount: 0,
    flowing: false,
    ended: true,
    endEmitted: true,
    reading: false,
    sync: true,
    needReadable: false,
    emittedReadable: false,
    readableListening: false,
    resumeScheduled: false,
    paused: true,
    emitClose: false,
    autoDestroy: false,
    destroyed: false,
    defaultEncoding: 'utf8',
    awaitDrain: 0,
    readingMore: false,
    decoder: null,
    encoding: null
  },
  readable: false,
  _events: [Object: null prototype] {
    end: [ [Function: bound onceWrapper] ],
    timeout: [Function: socketOnTimeout]
  },
  _eventsCount: 2,
  _maxListeners: undefined,
  _writableState: WritableState {
    objectMode: false,
    highWaterMark: 16384,
    finalCalled: false,
    needDrain: false,
    ending: false,
    ended: false,
    finished: false,
    destroyed: false,
    decodeStrings: true,
    defaultEncoding: 'utf8',
    length: 0,
    writing: false,
    corked: 0,
    sync: true,
    bufferProcessing: false,
    onwrite: [Function: bound onwrite],
    writecb: null,
    writelen: 0,
    bufferedRequest: null,
    lastBufferedRequest: null,
    pendingcb: 0,
    prefinished: false,
    errorEmitted: false,
    emitClose: false,
    autoDestroy: false,
    bufferedRequestCount: 0,
    corkedRequestsFree: [Object]
  },
  writable: true,
  allowHalfOpen: true,
  _bytesDispatched: 0,
  _sockname: null,
  _pendingData: null,
  _pendingEncoding: '',
  server: Server {
    _events: [Object: null prototype] {
      listening: [Function: bound init],
      close: [Function: bound destroy],
      upgrade: [Function],
      request: [Function]
    },
    _eventsCount: 4,
    _maxListeners: undefined,
    _connections: 0,
    _handle: TCP {
      reading: false,
      onconnection: [Function: onconnection],
      [Symbol(owner)]: [Circular]
    },
    _usingWorkers: false,
    _workers: null,
    _unref: false,
    allowHalfOpen: true,
    pauseOnConnect: false,
    httpAllowHalfOpen: false,
    timeout: 0,
    keepAliveTimeout: 5000,
    maxHeadersCount: null,
    headersTimeout: 60000,
    _connectionKey: '6::::3000',
    [Symbol(IncomingMessage)]: [Function: IncomingMessage],
    [Symbol(ServerResponse)]: [Function: ServerResponse],
    [Symbol(kCapture)]: false
  },
  _server: Server {
    _events: [Object: null prototype] {
      listening: [Function: bound init],
      close: [Function: bound destroy],
      upgrade: [Function],
      request: [Function]
    },
    _eventsCount: 4,
    _maxListeners: undefined,
    _connections: 0,
    _handle: TCP {
      reading: false,
      onconnection: [Function: onconnection],
      [Symbol(owner)]: [Circular]
    },
    _usingWorkers: false,
    _workers: null,
    _unref: false,
    allowHalfOpen: true,
    pauseOnConnect: false,
    httpAllowHalfOpen: false,
    timeout: 0,
    keepAliveTimeout: 5000,
    maxHeadersCount: null,
    headersTimeout: 60000,
    _connectionKey: '6::::3000',
    [Symbol(IncomingMessage)]: [Function: IncomingMessage],
    [Symbol(ServerResponse)]: [Function: ServerResponse],
    [Symbol(kCapture)]: false
  },
  _idleTimeout: -1,
  _idleNext: null,
  _idlePrev: null,
  _idleStart: -1,
  _destroyed: false,
  [Symbol(asyncId)]: 29,
  [Symbol(lastWriteQueueSize)]: 0,
  [Symbol(kBytesRead)]: 0,
  [Symbol(kBytesWritten)]: 0
}

注意

在使用 request.socket 属性时，需要保证 request 对象已被完全构建。 否则，在访问 request.socket 属性时，可能会导致该属性返回 undefined。