axiosist

axiosist

Axios based supertest: convert node.js request handler to axios adapter, used for node.js server unit test.

Why another supertest

Supertest(Superagent) is build on callbacks.

supertest(app).get('/').end((err, res) => console.log(res.data))

Although compatible with stream mode & promise mode.

// Stream mode
fs.createReadStream('foo.txt')
.pipe(supertest(app).post('/'))
.on('response', res => console.log('Successful.'))

// Promise mode
supertest(app).delete('/').then(
    res => console.log('Successful.'),
    err => console.log('Failed.')
)

We can use one mode of them, but not multi modes together.

fs.createReadStream('foo.txt')
.pipe(supertest(app).post('/')).then(
    res => console.log('Successful.'),
    err => console.log('Failed.')
) // Boom: two requests sent.

Axios is build on promises, and easy to use with callbacks & streams together.

axiosist(app).post('/', fs.createReadStream('foo.txt')).then(
    res => console.log('Successful.'),
    err => console.log('Failed.')
) // Works

It may be more suitable for some specific test cases.

Install

npm install --save-dev axiosist

Usage

// App
const express = require('express')
const app = express()

app.get('/', (req, res) => res.status(201).send('foo'))

// Unit test
const assert = require('assert')
const axiosist = require('axiosist')
axiosist(app).get('/').then(response => {
    assert.strictEqual(201, response.statusCode)
    assert.strictEqual('foo', response.data)
})

API

axiosist(callback)

Create an axios instance with adapter of the request callback, and treat all HTTP statuses as fulfilled.

axiosist.createAdapter(callback)

Create the adapter of the request callback, used for your own axios instance.

axiosist(callback)

is equal to

axios.create({ adapter: axiosist.createAdapter(callback) })

Misc

Axiosist will keep the host header of the request, for example

const express = require('express')
const app = require('app')

app.get('/', (req, res) => res.send(req.get('host')))


const assert = require('assert')
const axiosist = require('axiosist')
axiosist(app).get('/').then(response => {
    assert.strictEqual('127.0.0.1:5xxxxx', response.data)
})
axiosist(app).get('http://www.example.com:3912/').then(response => {
    assert.strictEqual('www.example.com:3912', response.data)
})

License

MIT