if (host !== null && host !== undefined && typeof host !== 'string') {

throw new ERR_INVALID_ARG_TYPE(`options.${name}`,

['string', 'undefined', 'null'],

host);

}

return host;

constructor(type, req) {

this.type = type;

this.req = req;

}

FunctionPrototypeCall(OutgoingMessage, this);

if (typeof input === 'string') {

const urlStr = input;

input = urlToHttpOptions(new URL(urlStr));

} else if (isURL(input)) {

// url.URL instance

input = urlToHttpOptions(input);

} else {

cb = options;

options = input;

input = null;

}

if (typeof options === 'function') {

cb = options;

options = input || kEmptyObject;

} else {

options = ObjectAssign(input || {}, options);

}

let agent = options.agent;

const defaultAgent = options._defaultAgent || Agent.globalAgent;

if (agent === false) {

agent = new defaultAgent.constructor();

} else if (agent === null || agent === undefined) {

if (typeof options.createConnection !== 'function') {

agent = defaultAgent;

}

// Explicitly pass through this statement as agent will not be used

// when createConnection is provided.

} else if (typeof agent.addRequest !== 'function') {

throw new ERR_INVALID_ARG_TYPE('options.agent',

['Agent-like Object', 'undefined', 'false'],

agent);

}

this.agent = agent;

const protocol = options.protocol || defaultAgent.protocol;

let expectedProtocol = defaultAgent.protocol;

if (this.agent && this.agent.protocol)

expectedProtocol = this.agent.protocol;

if (options.path) {

const path = String(options.path);

if (RegExpPrototypeExec(INVALID_PATH_REGEX, path) !== null) {

debug('Path contains unescaped characters: "%s"', path);

throw new ERR_UNESCAPED_CHARACTERS('Request path');

}

}

if (protocol !== expectedProtocol) {

throw new ERR_INVALID_PROTOCOL(protocol, expectedProtocol);

}

const defaultPort = options.defaultPort ||

(this.agent && this.agent.defaultPort);

const optsWithoutSignal = { __proto__: null, ...options };

const port = optsWithoutSignal.port = options.port || defaultPort || 80;

const host = optsWithoutSignal.host = validateHost(options.hostname, 'hostname') ||

validateHost(options.host, 'host') || 'localhost';

const setHost = (options.setHost === undefined || Boolean(options.setHost));

this.socketPath = options.socketPath;

if (options.timeout !== undefined)

this.timeout = getTimerDuration(options.timeout, 'timeout');

const signal = options.signal;

if (signal) {

addAbortSignal(signal, this);

delete optsWithoutSignal.signal;

}

let method = options.method;

const methodIsString = (typeof method === 'string');

if (method !== null && method !== undefined && !methodIsString) {

throw new ERR_INVALID_ARG_TYPE('options.method', 'string', method);

}

if (methodIsString && method) {

if (!checkIsHttpToken(method)) {

throw new ERR_INVALID_HTTP_TOKEN('Method', method);

}

method = this.method = StringPrototypeToUpperCase(method);

} else {

method = this.method = 'GET';

}

const maxHeaderSize = options.maxHeaderSize;

if (maxHeaderSize !== undefined)

validateInteger(maxHeaderSize, 'maxHeaderSize', 0);

this.maxHeaderSize = maxHeaderSize;

const insecureHTTPParser = options.insecureHTTPParser;

if (insecureHTTPParser !== undefined) {

validateBoolean(insecureHTTPParser, 'options.insecureHTTPParser');

}

this.insecureHTTPParser = insecureHTTPParser;

if (options.joinDuplicateHeaders !== undefined) {

validateBoolean(options.joinDuplicateHeaders, 'options.joinDuplicateHeaders');

}

this.joinDuplicateHeaders = options.joinDuplicateHeaders;

this.path = options.path || '/';

if (cb) {

this.once('response', cb);

}

if (method === 'GET' ||

method === 'HEAD' ||

method === 'DELETE' ||

method === 'OPTIONS' ||

method === 'TRACE' ||

method === 'CONNECT') {

this.useChunkedEncodingByDefault = false;

} else {

this.useChunkedEncodingByDefault = true;

}

this._ended = false;

this.res = null;

this.aborted = false;

this.timeoutCb = null;

this.upgradeOrConnect = false;

this.parser = null;

this.maxHeadersCount = null;

this.reusedSocket = false;

this.host = host;

this.protocol = protocol;

if (this.agent) {

// If there is an agent we should default to Connection:keep-alive,

// but only if the Agent will actually reuse the connection!

// If it's not a keepAlive agent, and the maxSockets==Infinity, then

// there's never a case where this socket will actually be reused

if (!this.agent.keepAlive && !NumberIsFinite(this.agent.maxSockets)) {

this._last = true;

this.shouldKeepAlive = false;

} else {

this._last = false;

this.shouldKeepAlive = true;

}

}

const headersArray = ArrayIsArray(options.headers);

if (!headersArray) {

if (options.headers) {

const keys = ObjectKeys(options.headers);

// Retain for(;;) loop for performance reasons

// Refs: https://github.com/nodejs/node/pull/30958

for (let i = 0; i < keys.length; i++) {

const key = keys[i];

this.setHeader(key, options.headers[key]);

}

}

if (host && !this.getHeader('host') && setHost) {

let hostHeader = host;

// For the Host header, ensure that IPv6 addresses are enclosed

// in square brackets, as defined by URI formatting

// https://tools.ietf.org/html/rfc3986#section-3.2.2

const posColon = StringPrototypeIndexOf(hostHeader, ':');

if (posColon !== -1 &&

StringPrototypeIncludes(hostHeader, ':', posColon + 1) &&

StringPrototypeCharCodeAt(hostHeader, 0) !== 91/* '[' */) {

hostHeader = `[${hostHeader}]`;

}

if (port && +port !== defaultPort) {

hostHeader += ':' + port;

}

this.setHeader('Host', hostHeader);

}

if (options.auth && !this.getHeader('Authorization')) {

this.setHeader('Authorization', 'Basic ' +

Buffer.from(options.auth).toString('base64'));

}

if (this.getHeader('expect')) {

if (this._header) {

throw new ERR_HTTP_HEADERS_SENT('render');

}

this._storeHeader(this.method + ' ' + this.path + ' HTTP/1.1\r\n',

this[kOutHeaders]);

}

} else {

this._storeHeader(this.method + ' ' + this.path + ' HTTP/1.1\r\n',

options.headers);

}

this[kUniqueHeaders] = parseUniqueHeadersOption(options.uniqueHeaders);

// initiate connection

if (this.agent) {

this.agent.addRequest(this, optsWithoutSignal);

} else {

// No agent, default to Connection:close.

this._last = true;

this.shouldKeepAlive = false;

let opts = optsWithoutSignal;

if (opts.path || opts.socketPath) {

opts = { ...optsWithoutSignal };

if (opts.socketPath) {

opts.path = opts.socketPath;

} else if (opts.path) {

opts.path = undefined;

}

}

if (typeof opts.createConnection === 'function') {

const oncreate = once((err, socket) => {

if (err) {

process.nextTick(() => this.emit('error', err));

} else {

this.onSocket(socket);

}

});

try {

const newSocket = opts.createConnection(opts, oncreate);

if (newSocket) {

oncreate(null, newSocket);

}

} catch (err) {

oncreate(err);

}

} else {

debug('CLIENT use net.createConnection', opts);

this.onSocket(net.createConnection(opts));

}

}

FunctionPrototypeCall(OutgoingMessage.prototype._finish, this);

if (hasObserver('http')) {

startPerf(this, kClientRequestStatistics, {

type: 'http',

name: 'HttpClient',

detail: {

req: {

method: this.method,

url: `${this.protocol}//${this.host}${this.path}`,

headers: typeof this.getHeaders === 'function' ? this.getHeaders() : {},

},

},

});

}

if (onClientRequestStartChannel.hasSubscribers) {

onClientRequestStartChannel.publish({

request: this,

});

}

if (isTraceHTTPEnabled()) {

this._traceEventId = getNextTraceEventId();

traceBegin(HTTP_CLIENT_TRACE_EVENT_NAME, this._traceEventId);

}

if (this._header) {

throw new ERR_HTTP_HEADERS_SENT('render');

}

this._storeHeader(this.method + ' ' + this.path + ' HTTP/1.1\r\n',

this[kOutHeaders]);

if (this.aborted) {

return;

}

this.aborted = true;

process.nextTick(emitAbortNT, this);

this.destroy();

if (this.destroyed) {

return this;

}

this.destroyed = true;

// If we're aborting, we don't care about any more response data.

if (this.res) {

this.res._dump();

}

this[kError] = err;

this.socket?.destroy(err);

return this;

const msg = this._httpMessage;

if (msg && !msg.finished && msg[kNeedDrain]) {

msg[kNeedDrain] = false;

msg.emit('drain');

}

const socket = this;

const req = socket._httpMessage;

debug('HTTP socket close');

// NOTE: It's important to get parser here, because it could be freed by

// the `socketOnData`.

const parser = socket.parser;

const res = req.res;

req.destroyed = true;

if (res) {

// Socket closed before we emitted 'end' below.

if (!res.complete) {

res.destroy(new ConnResetException('aborted'));

}

req._closed = true;

req.emit('close');

if (!res.aborted && res.readable) {

res.push(null);

}

} else {

if (!req.socket._hadError) {

// This socket error fired before we started to

// receive a response. The error needs to

// fire on the request.

req.socket._hadError = true;

req.emit('error', new ConnResetException('socket hang up'));

}

req._closed = true;

req.emit('close');

}

// Too bad. That output wasn't getting written.

// This is pretty terrible that it doesn't raise an error.

// Fixed better in v0.10

if (req.outputData)

req.outputData.length = 0;

if (parser) {

parser.finish();

freeParser(parser, req, socket);

}

const socket = this;

const req = socket._httpMessage;

debug('SOCKET ERROR:', err.message, err.stack);

if (req) {

// For Safety. Some additional errors might fire later on

// and we need to make sure we don't double-fire the error event.

req.socket._hadError = true;

req.emit('error', err);

}

const parser = socket.parser;

if (parser) {

parser.finish();

freeParser(parser, req, socket);

}

// Ensure that no further data will come out of the socket

socket.removeListener('data', socketOnData);

socket.removeListener('end', socketOnEnd);

socket.destroy();

const socket = this;

const req = this._httpMessage;

const parser = this.parser;

if (!req.res && !req.socket._hadError) {

// If we don't have a response then we know that the socket

// ended prematurely and we need to emit an error on the request.

req.socket._hadError = true;

req.emit('error', new ConnResetException('socket hang up'));

}

if (parser) {

parser.finish();

freeParser(parser, req, socket);

}

socket.destroy();

const socket = this;

const req = this._httpMessage;

const parser = this.parser;

assert(parser && parser.socket === socket);

const ret = parser.execute(d);

if (ret instanceof Error) {

prepareError(ret, parser, d);

debug('parse error', ret);

freeParser(parser, req, socket);

socket.removeListener('data', socketOnData);

socket.removeListener('end', socketOnEnd);

socket.destroy();

req.socket._hadError = true;

req.emit('error', ret);

} else if (parser.incoming && parser.incoming.upgrade) {

// Upgrade (if status code 101) or CONNECT

const bytesParsed = ret;

const res = parser.incoming;

req.res = res;

socket.removeListener('data', socketOnData);

socket.removeListener('end', socketOnEnd);

socket.removeListener('drain', ondrain);

if (req.timeoutCb) socket.removeListener('timeout', req.timeoutCb);

socket.removeListener('timeout', responseOnTimeout);

parser.finish();

freeParser(parser, req, socket);

const bodyHead = TypedArrayPrototypeSlice(d, bytesParsed, d.length);

const eventName = req.method === 'CONNECT' ? 'connect' : 'upgrade';

if (req.listenerCount(eventName) > 0) {

req.upgradeOrConnect = true;

// detach the socket

socket.emit('agentRemove');

socket.removeListener('close', socketCloseListener);

socket.removeListener('error', socketErrorListener);

socket._httpMessage = null;

socket.readableFlowing = null;

req.emit(eventName, res, socket, bodyHead);

req.destroyed = true;

req._closed = true;

req.emit('close');

} else {

// Requested Upgrade or used CONNECT method, but have no handler.

socket.destroy();

}

} else if (parser.incoming && parser.incoming.complete &&

// When the status code is informational (100, 102-199),

// the server will send a final response after this client

// sends a request body, so we must not free the parser.

// 101 (Switching Protocols) and all other status codes

// should be processed normally.

!statusIsInformational(parser.incoming.statusCode)) {

socket.removeListener('data', socketOnData);

socket.removeListener('end', socketOnEnd);

socket.removeListener('drain', ondrain);

freeParser(parser, req, socket);

}

// 100 (Continue) RFC7231 Section 6.2.1

// 102 (Processing) RFC2518

// 103 (Early Hints) RFC8297

// 104-199 (Unassigned)

return (status < 200 && status >= 100 && status !== 101);

const socket = this.socket;

const req = socket._httpMessage;

debug('AGENT incoming response!');

if (req.res) {

// We already have a response object, this means the server

// sent a double response.

socket.destroy();

return 0; // No special treatment.

}

req.res = res;

// Skip body and treat as Upgrade.

if (res.upgrade)

return 2;

// Responses to CONNECT request is handled as Upgrade.

const method = req.method;

if (method === 'CONNECT') {

res.upgrade = true;

return 2; // Skip body and treat as Upgrade.

}

if (statusIsInformational(res.statusCode)) {

// Restart the parser, as this is a 1xx informational message.

req.res = null; // Clear res so that we don't hit double-responses.

// Maintain compatibility by sending 100-specific events

if (res.statusCode === 100) {

req.emit('continue');

}

// Send information events to all 1xx responses except 101 Upgrade.

req.emit('information', {

statusCode: res.statusCode,

statusMessage: res.statusMessage,

httpVersion: res.httpVersion,

httpVersionMajor: res.httpVersionMajor,

httpVersionMinor: res.httpVersionMinor,

headers: res.headers,

rawHeaders: res.rawHeaders,

});

return 1; // Skip body but don't treat as Upgrade.

}

if (req.shouldKeepAlive && !shouldKeepAlive && !req.upgradeOrConnect) {

// Server MUST respond with Connection:keep-alive for us to enable it.

// If we've been upgraded (via WebSockets) we also shouldn't try to

// keep the connection open.

req.shouldKeepAlive = false;

}

if (req[kClientRequestStatistics] && hasObserver('http')) {

stopPerf(req, kClientRequestStatistics, {

detail: {

res: {

statusCode: res.statusCode,

statusMessage: res.statusMessage,

headers: res.headers,

},

},

});

}

if (onClientResponseFinishChannel.hasSubscribers) {

onClientResponseFinishChannel.publish({

request: req,

response: res,

});

}

if (isTraceHTTPEnabled() && typeof req._traceEventId === 'number') {

traceEnd(HTTP_CLIENT_TRACE_EVENT_NAME, req._traceEventId, {

path: req.path,

statusCode: res.statusCode,

});

}

req.res = res;

res.req = req;

// Add our listener first, so that we guarantee socket cleanup

res.on('end', responseOnEnd);

req.on('finish', requestOnFinish);

socket.on('timeout', responseOnTimeout);

// If the user did not listen for the 'response' event, then they

// can't possibly read the data, so we ._dump() it into the void

// so that the socket doesn't hang there in a paused state.

if (req.aborted || !req.emit('response', res))

res._dump();

if (method === 'HEAD')

return 1; // Skip body but don't treat as Upgrade.

if (res.statusCode === 304) {

res.complete = true;

return 1; // Skip body as there won't be any

}

return 0; // No special treatment.

const socket = req.socket;

debug('AGENT socket keep-alive');

if (req.timeoutCb) {

socket.setTimeout(0, req.timeoutCb);

req.timeoutCb = null;

}

socket.removeListener('close', socketCloseListener);

socket.removeListener('error', socketErrorListener);

socket.removeListener('data', socketOnData);

socket.removeListener('end', socketOnEnd);

// TODO(ronag): Between here and emitFreeNT the socket

// has no 'error' handler.

// There are cases where _handle === null. Avoid those. Passing undefined to

// nextTick() will call getDefaultTriggerAsyncId() to retrieve the id.

const asyncId = socket._handle ? socket._handle.getAsyncId() : undefined;

// Mark this socket as available, AFTER user-added end

// handlers have a chance to run.

defaultTriggerAsyncIdScope(asyncId, process.nextTick, emitFreeNT, req);

req.destroyed = true;

if (req.res) {

// Detach socket from IncomingMessage to avoid destroying the freed

// socket in IncomingMessage.destroy().

req.res.socket = null;

}

const req = this.req;

const socket = req.socket;

if (socket) {

if (req.timeoutCb) socket.removeListener('timeout', emitRequestTimeout);

socket.removeListener('timeout', responseOnTimeout);

}

req._ended = true;

if (!req.shouldKeepAlive) {

if (socket.writable) {

debug('AGENT socket.destroySoon()');

if (typeof socket.destroySoon === 'function')

socket.destroySoon();

else

socket.end();

}

assert(!socket.writable);

} else if (req.writableFinished && !this.aborted) {

assert(req.finished);

// We can assume `req.finished` means all data has been written since:

// - `'responseOnEnd'` means we have been assigned a socket.

// - when we have a socket we write directly to it without buffering.

// - `req.finished` means `end()` has been called and no further data.

// can be written

// In addition, `req.writableFinished` means all data written has been

// accepted by the kernel. (i.e. the `req.socket` is drained).Without

// this constraint, we may assign a non drained socket to a request.

responseKeepAlive(req);

}

const req = this._httpMessage;

if (!req) return;

const res = req.res;

if (!res) return;

res.emit('timeout');

const req = this;

if (req.shouldKeepAlive && req._ended)

responseKeepAlive(req);

req._closed = true;

req.emit('close');

if (req.socket) {

req.socket.emit('free');

}

const parser = parsers.alloc();

req.socket = socket;

const lenient = req.insecureHTTPParser === undefined ?

isLenient() : req.insecureHTTPParser;

parser.initialize(HTTPParser.RESPONSE,

new HTTPClientAsyncResource('HTTPINCOMINGMESSAGE', req),

req.maxHeaderSize || 0,

lenient ? kLenientAll : kLenientNone);

parser.socket = socket;

parser.outgoing = req;

req.parser = parser;

socket.parser = parser;

socket._httpMessage = req;

// Propagate headers limit from request object to parser

if (typeof req.maxHeadersCount === 'number') {

parser.maxHeaderPairs = req.maxHeadersCount << 1;

}

parser.joinDuplicateHeaders = req.joinDuplicateHeaders;

parser.onIncoming = parserOnIncomingClient;

socket.on('error', socketErrorListener);

socket.on('data', socketOnData);

socket.on('end', socketOnEnd);

socket.on('close', socketCloseListener);

socket.on('drain', ondrain);

if (

req.timeout !== undefined ||

(req.agent && req.agent.options && req.agent.options.timeout)

) {

listenSocketTimeout(req);

}

req.emit('socket', socket);

const req = this._httpMessage;

if (req) {

req.emit('timeout');

}

if (req.timeoutCb) {

return;

}

// Set timeoutCb so it will get cleaned up on request end.

req.timeoutCb = emitRequestTimeout;

// Delegate socket timeout event.

if (req.socket) {

req.socket.once('timeout', emitRequestTimeout);

} else {

req.on('socket', (socket) => {

socket.once('timeout', emitRequestTimeout);

});

}