Как один блок тестирует маршруты с Express?

Question

Я нахожусь в процессе изучения Node.js и играюсь с Express . Очень нравится фреймворк, но мне сложно понять, как написать тестовый модуль / интеграционный тест для маршрута.

Возможность модульного тестирования простых модулей проста, и они делают это с Mocha ; однако мои модульные тесты с Express не пройдены, так как объект ответа, который я передаю, не сохраняет значения.

Тестируемая функция маршрута (маршруты / index.js):

exports.index = function(req, res){
  res.render('index', { title: 'Express' })
};

Модуль модульного тестирования:

var should = require("should")
    , routes = require("../routes");

var request = {};
var response = {
    viewName: ""
    , data : {}
    , render: function(view, viewData) {
        viewName = view;
        data = viewData;
    }
};

describe("Routing", function(){
    describe("Default Route", function(){
        it("should provide the a title and the index view name", function(){
        routes.index(request, response);
        response.viewName.should.equal("index");
        });

    });
});

Когда я запускаю это, происходит ошибка «Ошибка: обнаружены глобальные утечки: viewName, data».

1. Где я иду не так, чтобы я мог заставить это работать?

2. Есть ли лучший способ для меня тестировать мой код на этом уровне?

Обновление 1. Исправлен фрагмент кода, так как я изначально забыл "it ()".

Answer 1

Как другие рекомендовали в комментариях, похоже, что канонический способ тестирования контроллеров Express - это supertest .

Пример теста может выглядеть следующим образом:

describe('GET /users', function(){
  it('respond with json', function(done){
    request(app)
      .get('/users')
      .set('Accept', 'application/json')
      .expect(200)
      .end(function(err, res){
        if (err) return done(err);
        done()
      });
  })
});

Вверх: вы можете протестировать весь свой стек за один раз.

Вниз: он выглядит и действует как интеграционное тестирование.

Answer 2

Измените ваш объект ответа:

var response = {
    viewName: ""
    , data : {}
    , render: function(view, viewData) {
        this.viewName = view;
        this.data = viewData;
    }
};

И это будет работать.

Answer 3

Самый простой способ проверить HTTP с помощью экспресса - это украсть http-помощник TJ

I лично использовать его помощника

it("should do something", function (done) {
    request(app())
    .get('/session/new')
    .expect('GET', done)
})

Вы хотите специально протестировать свой объект маршрутов, а затем передать правильные макеты

describe("Default Route", function(){
    it("should provide the a title and the index view name", function(done){
        routes.index({}, {
            render: function (viewName) {
                viewName.should.equal("index")
                done()
            }
        })
    })
})

Answer 4

Я пришел к выводу, что единственный способ по-настоящему модульного тестирования экспресс-приложений - поддерживать большое разделение между обработчиками запросов и логикой вашего ядра.

Таким образом, логика вашего приложения должна быть в отдельных модулях, которые могут быть require d и подвергнуты модульному тестированию, и иметь минимальную зависимость от классов Express Request и Response как таковых.

Затем в обработчиках запросов вам нужно вызывать соответствующие методы ваших основных классов логики.

Я приведу пример, как только закончу реструктуризацию моего текущего приложения!

Полагаю, что-то вроде это? (Не стесняйтесь раскошелиться или прокомментировать, я все еще изучаю это).

Редактировать

Вот небольшой пример, встроенный. См. суть для более подробного примера.

/// usercontroller.js
var UserController = {
   _database: null,
   setDatabase: function(db) { this._database = db; },

   findUserByEmail: function(email, callback) {
       this._database.collection('usercollection').findOne({ email: email }, callback);
   }
};

module.exports = UserController;

/// routes.js

/* GET user by email */
router.get('/:email', function(req, res) {
    var UserController = require('./usercontroller');
    UserController.setDB(databaseHandleFromSomewhere);
    UserController.findUserByEmail(req.params.email, function(err, result) {
        if (err) throw err;
        res.json(result);
    });
});

Answer 5

если модульное тестирование с экспресс-4, обратите внимание на этот пример из gjohnson :

var express = require('express');
var request = require('supertest');
var app = express();
var router = express.Router();
router.get('/user', function(req, res){
  res.send(200, { name: 'tobi' });
});
app.use(router);
request(app)
  .get('/user')
  .expect('Content-Type', /json/)
  .expect('Content-Length', '15')
  .expect(200)
  .end(function(err, res){
    if (err) throw err;
  });

Answer 6

Чтобы выполнить модульное тестирование вместо интеграционного тестирования, я смоделировал объект ответа обработчика запросов.

/* app.js */
import endpointHandler from './endpointHandler';
// ...
app.post('/endpoint', endpointHandler);
// ...

/* endpointHandler.js */
const endpointHandler = (req, res) => {
  try {
    const { username, location } = req.body;

    if (!(username && location)) {
      throw ({ status: 400, message: 'Missing parameters' });
    }

    res.status(200).json({
      location,
      user,
      message: 'Thanks for sharing your location with me.',
    });
  } catch (error) {
    console.error(error);
    res.status(error.status).send(error.message);
  }
};

export default endpointHandler;

/* response.mock.js */
import { EventEmitter } from 'events';

class Response extends EventEmitter {
  private resStatus;

  json(response, status) {
    this.send(response, status);
  }

  send(response, status) {
    this.emit('response', {
      response,
      status: this.resStatus || status,
    });
  }

  status(status) {
    this.resStatus = status;
    return this;
  }
}

export default Response;

/* endpointHandler.test.js */
import Response from './response.mock';
import endpointHandler from './endpointHander';

describe('endpoint handler test suite', () => {
  it('should fail on empty body', (done) => {
    const res = new Response();

    res.on('response', (response) => {
      expect(response.status).toBe(400);
      done();
    });

    endpointHandler({ body: {} }, res);
  });
});

Затем, чтобы выполнить интеграционное тестирование, вы можете смоделировать свой endpointHandler и вызвать конечную точку с помощью Supertest .

Answer 7

Мне тоже было интересно, но именно для юнит-тестов, а не для интеграционных тестов.Это то, что я делаю сейчас,

test('/api base path', function onTest(t) {
  t.plan(1);

  var path = routerObj.path;

  t.equals(path, '/api');
});


test('Subrouters loaded', function onTest(t) {
  t.plan(1);

  var router = routerObj.router;

  t.equals(router.stack.length, 5);
});

Где routerObj просто {router: expressRouter, path: '/api'}.Затем я загружаю в подручи с помощью var loginRouterInfo = require('./login')(express.Router({mergeParams: true}));, а затем приложение Express вызывает функцию init, принимающую в качестве параметра маршрутизатор Express.Затем initRouter вызывает router.use(loginRouterInfo.path, loginRouterInfo.router); для монтирования подчиненного маршрутизатора.

Подуровень можно протестировать с помощью:

var test = require('tape');
var routerInit = require('../login');
var express = require('express');
var routerObj = routerInit(express.Router());

test('/login base path', function onTest(t) {
  t.plan(1);

  var path = routerObj.path;

  t.equals(path, '/login');
});


test('GET /', function onTest(t) {
  t.plan(2);

  var route = routerObj.router.stack[0].route;

  var routeGetMethod = route.methods.get;
  t.equals(routeGetMethod, true);

  var routePath = route.path;
  t.equals(routePath, '/');
});