mini-application

Mini Application

Express app and sinon mocks to the rescue!

Installation

npm i mini-application --save

yarn add -S mini-application

const MiniApplication = require("mini-application")
const miniApp = new MiniApplication();

Stub

What happens when you wrap Express middleware with Sinon stub? See below:

Stub simple endpoint

const MiniApplication = require("mini-application")
const miniApp = new MiniApplication();

miniApp.stubApp("/test").respond((req, res) => {
  res.end("ok!");
});

miniApp.listen(3000)
.then(() => {
  rp.get("http://localhost:3000/test")
    .then((response) => {
      assert(response.body === "ok!");
    });
});

Stub different responses

miniApp.stubApp("/test")
  .onFirstCall()
  .respond((req, res) => res.end("first response"))
  .onSecondCall()
  .respond((req, res) => res.end("first response"));

Stub specific method only

miniApp.stubApp("post", "/test").respond((req, res) => res.end("on post call only"));

Use sinon helpers

miniApp.stubApp("/test").respond({ text: "json response" });
// or
miniApp.stubApp("/test").respond(503);
// or
miniApp.stubApp("/test").respond("ok");

Events

It's often helpful to get nice callback the verify the expectations

Simple event emitted for path

request.get("http://localhost:3000/test").end();
miniApp.on("incoming.request@/test", (req) => {
  expect(req.url).to.be.equal("/test");
  done();
});

Interactive

Sometimes it's hard to write a good test without manual verification first. Miniapp should help here too:

bin/mini-application
miniApp - listening on 3000
miniApp > stubApp("/").respond("ok")
# now open http://localhost:3000/ in the browser to see the response
# then you can inspect all requests which were made to the miniApp instance:
miniApp > requests.get("incoming").value()