Produces a socket/stream to be used for HTTP requests.
Produces a socket/stream to be used for HTTP requests. By default, this function is the same as net.createConnection(). However, custom Agents may override this method in case greater flexibility is desired.
A socket/stream can be supplied in one of two ways: by returning the socket/stream from this function, or by passing the socket/stream to callback.
callback has a signature of (err, stream).
agent.createConnection(options[, callback])
Destroy any sockets that are currently in use by the agent.
Destroy any sockets that are currently in use by the agent.
It is usually not necessary to do this. However, if you are using an agent with KeepAlive enabled, then it is best to explicitly shut down the agent when you know that it will no longer be used. Otherwise, sockets may hang open for quite a long time before the server terminates them.
agent.destroy()
The agent's domain name
The agent's domain name
An object which contains arrays of sockets currently awaiting use by the Agent when HTTP KeepAlive is used.
An object which contains arrays of sockets currently awaiting use by the Agent when HTTP KeepAlive is used. Do not modify.
agent.freeSockets
By default set to 256.
By default set to 256. For Agents supporting HTTP KeepAlive, this sets the maximum number of sockets that will be left open in the free state.
agent.maxFreeSockets
By default set to Infinity.
By default set to Infinity. Determines how many concurrent sockets the agent can have open per origin. Origin is either a 'host:port' or 'host:port:localAddress' combination.
agent.maxSockets
An object which contains queues of requests that have not yet been assigned to sockets.
An object which contains queues of requests that have not yet been assigned to sockets. Do not modify.
agent.requests
An object which contains arrays of sockets currently in use by the Agent.
An object which contains arrays of sockets currently in use by the Agent. Do not modify.
agent.sockets
HTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a separate module.