Injects a fake request into an HTTP server.
dispatchFunc
- listener function. The same as you would pass toHttp.createServer
when making a node HTTP server. Has the signaturefunction (req, res)
where:req
- a simulated request object. Inherits fromStream.Readable
.res
- a simulated response object. Inherits from node'sHttp.ServerResponse
.
options
- request options object where:url
- a string specifying the request URL.method
- a string specifying the HTTP request method, defaulting to'GET'
.authority
- a string specifying the HTTP HOST header value to be used if no header is provided, and theurl
does not include an authority component. Defaults to'localhost'
.headers
- an optional object containing request headers.remoteAddress
- an optional string specifying the client remote address. Defaults to'127.0.0.1'
.payload
- an optional request payload. Can be a string, Buffer, Stream or object.simulate
- an object containing flags to simulate various conditions:end
- indicates whether the request will fire anend
event. Defaults toundefined
, meaning anend
event will fire.split
- indicates whether the request payload will be split into chunks. Defaults toundefined
, meaning payload will not be chunked.error
- whether the request will emit anerror
event. Defaults toundefined
, meaning noerror
event will be emitted. If set totrue
, the emitted error will have a message of'Simulated'
.close
- whether the request will emit aclose
event. Defaults toundefined
, meaning noclose
event will be emitted.
callback
- the callback function using the signaturefunction (res)
where:res
- a response object where:raw
- an object containing the raw request and response objects where:req
- the simulated request object.res
- the simulated response object.
headers
- an object containing the response headers.statusCode
- the HTTP status code.statusMessage
- the HTTP status message.payload
- the payload as a UTF-8 encoded string.rawPayload
- the raw payload as a Buffer.trailers
- an object containing the response trailers.
Checks if given object obj
is a Shot Request
object.