Nearly Perpendicular Macaroons
Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

axiosist

0.3.0 • Public • Published

axiosist

Build Status Coverage Status dependencies Status devDependencies Status JavaScript Style Guide Greenkeeper badge

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

install

npm i axiosist

Downloadsweekly downloads

527

version

0.3.0

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability