README

express-as-promise

ExpressAsPromise is a simple Promise wrapper for Express. It also adds some convenient methods & properties which are especially useful for testing.

Usage

The package returns a class. Instances can be created without any options. The actual express object is available as .app property. The methods .listen and .stop start and stop the listener. The .url property contains a string to the base URL.

Methods

async fetch(url, options): Makes a request with node-fetch to the express server. The url is expanded using the servers base URL. If the server isn't listening yet, the server starts listening on a random port.
async listen(port, host): Forwards the optional port and host parameters to express method. Returns the base URL as string.
async stop(): Stops the listener.

Static Methods

withServer(callback): Creates a server instance and hands it over to an async callback function. Once the callback function finished with resolve or reject, it stops the server and forwards the error if it finished with reject. This method is intended for testing using a pattern like this:

const { withServer } = require('express-as-promise')

it('should handle my test case', async () => {
  await withServer(async server => {
    server.app.use(myMiddleware)

    const url = await server.listen()

    const res = await fetch(url)

    strictEqual(res.status, 200)
  })
})

Properties

.app: The actual express object.
.url: The base URL of the listener.

Example

Simple example which adds one route, starts the server, write the base URL to the console and waits 10s before it stops the server.

const ExpressAsPromise = require('express-as-promise')

async function main () {
  // creates a new instance which also creates an express object
  const server = new ExpressAsPromise()

  server.app.get('/', (req, res) => {
    res.send('Hello World!')
  })

  // starts the listener and writes the base URL to the console
  console.log(await server.listen())

  // wait 10s...
  await (new Promise(resolve => setTimeout(resolve, 10000)))

  // ...then stop the server
  await server.stop()
}

main()

Usage no npm install needed!