如何调用 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()
这是你不想在你的测试。
我不知道我怎么称呼这可能 '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()
这是你不想在你的测试。