test-client

test-client is a small HTTP assertion library.

``js
'use strict'

const http = require('http')
const Client = require('test-client')

async function test () {
const server = http.createServer((request, response) => {
response.setHeader('content-type', 'application/json')
response.end(JSON.stringify({x: 2}))
})

const client = new Client(server)

const response = await client
.get('/test')
.type('json')
.accept('json')
.set('user-agent', 'smith')
.send({x: 1})

response
.assert(200, {x: 2})
.assert('content-type', /json/)
}
`

Install

npm install test-client

API

Client

$3

app can be a [koa][koa]/[express][express] app, an http.Server, or anything
with a .listen() method.

$3

Returns a Request with the corresponding path and method. method can be
any of the values in http.METHODS.

$3

There is a convenience method proxying .request(…) for each method in
http.METHODS. Returns a Request.

$3

A [CookieJar][cookiejar] instance for storing cookies.

Request

$3

Set a request header by key and value. Returns the request.

$3

Set headers from an object containing header key/value pairs. Returns the
request.

$3

Set the accept header from a content-type or extension via
[mime-types][mime-types]. Returns the request.

$3

Set the content-type header from a content-type or extension via
[mime-types][mime-types]. Returns the request.

$3

Send the request with no body. Returns a promise that resolves as a Response.

$3

Send the request with the specified body. If body is an object, it's JSON
encoded and content-type is set to application/json. If body is a stream,
it's piped to the request. Returns a promise that resolves as a Response.

Response

$3

The numeric status code from the response.

$3

An object containing header values from the response.

$3

If the response is JSON as indicated by the content-type`, the decoded
response. Otherwise, the response string.

$3

Assert the HTTP status value. Returns the response.

$3

Assert the repsonse body value. Returns the response.

$3

Assert that the response body matches a RegExp. Returns the response.

$3

Assert the response body as a JSON object. Returns the response.

$3

Assert the HTTP status and response body value. Returns the response.

$3

Assert the HTTP status value and the response body matches a RegExp. Returns
the response.

$3

Assert an HTTP header value. Returns the response.

$3

Assert an HTTP header matches a RegExp. Returns the response.

[koa]: http://koajs.com/
[express]: http://expressjs.com/
[cookiejar]: https://github.com/bmeck/node-cookiejar
[mime-types]: https://github.com/jshttp/mime-types