如何调用 Koa.js 应用程序实例进行单元测试

How to Make a Call to Koa.js App Instance for Unit Tests

我不知道我怎么称呼这可能 'static call to a koa router'?如果您从技术上谈论它,那么对于我真正想要完成的事情来说,这似乎是正确的措辞吗?

无论如何,我正在使用 koa-router 并且我正在编写单元测试(不是集成测试)。因此,由于这个原因,我不想在我的 koa 应用程序上调用 .listen() ......它会创建一个 http 服务器,现在使我的测试成为一个集成测试。

相反,在我的测试中,我只是想直接调用应用程序对象实例并调用路由,并且能够 return 没有结果并检查我 return 没有结果响应。

你怎么做到的?我找不到示例,我已经尝试了各种伪代码尝试再次尝试 koa 应用程序对象。

如果你想测试 koa-router 路由到的功能,那么只需对该功能执行单元测试并将路由排除在外。

对我来说,听起来您有一个 app.js 之类的文件,它包含您的所有代码。您可以做的是创建一个 router.js 文件来放置您的路由绑定和一个 services.js 文件,您可以在其中放置您的应用程序逻辑。

所以例如 app.js 可能看起来像:

var koa = require("koa");
var app = module.exports = koa();
var router = require('./router.js');

app.use(router.unsecured.middleware());

app.listen(3000);

而 router.js 可能看起来像:

var router = require("koa-router");
var service = require("./services.js");

var unsecured = module.exports.unsecured = new router();

unsecured.post('/account/signin', service.signinUser);
unsecured.post('/account/register', service.registerUser);

而 services.js 可能看起来像:

module.exports.signinUser  = function*(signinDetails) {
  // contains your application signin logic
};

module.exports.registerUser  = function*(registerDetails) {
  // contains your application register logic
};

因此您可以通过这种方式单独测试 services.js。我认为单独测试 router.js 没有任何价值,因为它太微不足道了。正如@Dan Pantry 所示,您可以使用 supertest 作为集成测试的一部分来测试路由。

编辑:

所以这是我用来测试路由是否正确的一个小实验测试。我使用 mocha 作为测试运行器和我在原始代码中发布的代码示例。

// standard library
var assert = require("assert");

// in app objects
var router = require('./router.js');
var service = require('./service.js');

describe("routing tests", function() {

  it("test register routing, POST", function*(done) {
    // arrange
    var unsecured = router.unsecured;
    var path = '/account/register';
    var httpMethod = 'POST';
    var expected = service.register.toString();
    var actual;

    // act
    for (var i = 0; i < unsecured.stack.length; i++)
    {
      var pathMatch = unsecured.stack[i].path === path;
      var methodMatch = unsecured.stack[i].methods.indexOf(httpMethod) >= 0;

      if (pathMatch && methodMatch)
      {
        actual = unsecured.stack[i].middleware.toString();
        break;
      }
    }

    // assert
    try {
      assert.equal(expected, actual);
      done();
    } catch(err) {
      done(err);
    }
  });    
});

可能有一种更简洁的方法(以及一种更模块化的方法来测试多条路径),但正如我所说,这只是验证路由是否调用正确服务的基本示例。我正在做的是深入研究 koa-router 对象,以根据 HTTP 方法(例如 POST、GET 等)验证什么路径绑定到什么服务代码。

如果你在模块中有你的路由和服务,这个测试完全避免处理主要的 koa 应用程序。虽然从技术上讲这个测试跨越多个单元(路由和服务代码)所以它在技术上是一个集成测试但它确实意味着你不要接近 app.listen() 这是你不想在你的测试。