angularjs 基于单元测试承诺的服务(SQlite 数据库服务)
angularjs unit test promise based service (SQlite database service)
我在单元测试 angularjs 应用程序方面非常陌生,我想我不理解在 angularjs 上测试基于承诺的服务的主要概念。
直接开始我的例子:
我有一个具有此方法的 SQLite 数据库服务:
var executeQuery = function(db,query,values,logMessage) {
return $cordovaSQLite.execute(db, query, values).then(function(res) {
if(res.rows.length>0) return res;
else return true;
}, function (err) {
return false;
});
};
我想编写一个测试用例,在其中执行查询,然后我想获取服务的 executeQuery 函数的 return 值。
我的测试描述是这样的:
describe("Test DatabaseCreateService‚", function () {
var DatabaseCreateService,cordovaSQLite,ionicPlatform,rootScope,q;
var db=null;
beforeEach(module("starter.services"));
beforeEach(module("ngCordova"));
beforeEach(module("ionic"));
beforeEach(inject(function (_DatabaseCreateService_, $cordovaSQLite,$ionicPlatform,$rootScope,$q) {
DatabaseCreateService = _DatabaseCreateService_;
cordovaSQLite = $cordovaSQLite;
ionicPlatform = $ionicPlatform;
q = $q;
rootScope = $rootScope;
ionicPlatform.ready(function() {
db = window.openDatabase("cgClientDB-Test.db", '1', 'my', 1024 * 1024 * 100);
});
}));
describe("Test DatabaseCreateService:createTableLocalValues", function() {
it("should check that the createTableLocalValues was called correctly and return correct data", function() {
var deferred = q.defer();
deferred.resolve(true);
spyOn(DatabaseCreateService,'createTableLocalValues').and.returnValue(deferred.promise);
var promise = DatabaseCreateService.createTableLocalValues(db);
expect(DatabaseCreateService.createTableLocalValues).toHaveBeenCalled();
expect(DatabaseCreateService.createTableLocalValues).toHaveBeenCalledWith(db);
expect(DatabaseCreateService.createTableLocalValues.calls.count()).toEqual(1);
promise.then(function(resp) {
expect(resp).not.toBe(undefined);
expect(resp).toBe(true);
},function(err) {
expect(err).not.toBe(true);
});
rootScope.$apply();
});
});
});
这个测试描述有效,但它没有 return 函数的值而不是它 return 在 deferred.resolve(true);
中解决了什么
我想做的是调用 DatabaseCreateService.createTableLocalValues 函数并解析从函数中获取 return 的数据。
createTableLocalValues 函数是这样的:
var createTableLocalValues = function(db) {
var query = "CREATE TABLE IF NOT EXISTS `local_values` (" +
"`Key` TEXT PRIMARY KEY NOT NULL," +
"`Value` TEXT );";
return executeQuery(db,query,[],"Create cg_local_values");
};
好吧,如果我 运行 在浏览器或设备上使用此方法,如果一切正常并且 table 已创建,我将获得真正的支持。那么我如何在测试描述中也得到这个真实的真实而不是像我上面的例子中的假真实?
感谢您的帮助。
示例 2(使用 callThrough):
describe('my fancy thing', function () {
beforeEach(function() {
spyOn(DatabaseCreateService,'createTableSettings').and.callThrough();
});
it('should be extra fancy', function (done) {
var promise = DatabaseCreateService.createTableSettings(db);
rootScope.$digest();
promise.then(function(resp) {
console.log(resp);
expect(resp).toBeDefined();
expect(resp).toBe(true);
done();
},function(err) {
done();
});
});
});
在 karma 中记录消息-运行ner:
LOG: true
Chrome 46.0.2490 (Mac OS X 10.11.1) Test DatabaseCreateService‚ testing createTable functions: my fancy thing should be extra fancy FAILED
Error: Timeout - Async callback was not invoked within timeout specified by jasmine.DEFAULT_TIMEOUT_INTERVAL.
Chrome 46.0.2490 (Mac OS X 10.11.1):执行了 42 次,共 42 次(1 次失败)(8.453 秒/8.03 秒)
更新:
原来这个问题与$cordovaSQLite.executeQuery函数本身有关。不知何故,它没有承诺超时,这就是错误的原因。我把ng-cordova的execute函数改成了这个。 (希望此更改不会破坏任何工作)
execute: function (db, query, binding) {
var q = Q.defer();
db.transaction(function (tx) {
tx.executeSql(query, binding, function (tx, result) {
q.resolve(result);
},
function (transaction, error) {
q.reject(error);
});
});
return q.promise.timeout( 5000, "The execute request took too long to respond." );
}
有了这个改变,测试正确通过了!
你可以监视一个函数,并委托给实际的实现,使用
spyOn(DatabaseCreateService,'createTableLocalValues').and.callThrough();
您可能还需要在调用函数后调用 rootScope.$digest()
,这样 promise 才会解析。
编辑:
测试异步代码时,您应该使用 done
模式:
it('should be extra fancy', function (done) {
var promise = DatabaseCreateService.createTableSettings(db);
rootScope.$digest();
promise.then(function(resp) {
console.log(resp);
expect(resp).toBeDefined();
expect(resp).toBe(false);
expect(resp).toBe(true);
done();
});
});
关于您在测试中断言方式的建议:
在您的测试中,您正在对返回的承诺调用 then
以做出您的断言:
promise.then(function(resp) {
expect(resp).not.toBe(undefined);
expect(resp).toBe(true);
},function(err) {
expect(err).not.toBe(true);
});
这迫使您在错误函数中添加一个断言,这样如果承诺根本没有解决,您的测试仍然会失败。
请尝试使用 Jasmine Promise Matchers。它将使您的测试代码更易于阅读,并在测试失败时导致更清晰的错误消息。您的测试看起来像这样:
expect(promise).toBeResolvedWith(true);
我在单元测试 angularjs 应用程序方面非常陌生,我想我不理解在 angularjs 上测试基于承诺的服务的主要概念。
直接开始我的例子:
我有一个具有此方法的 SQLite 数据库服务:
var executeQuery = function(db,query,values,logMessage) {
return $cordovaSQLite.execute(db, query, values).then(function(res) {
if(res.rows.length>0) return res;
else return true;
}, function (err) {
return false;
});
};
我想编写一个测试用例,在其中执行查询,然后我想获取服务的 executeQuery 函数的 return 值。
我的测试描述是这样的:
describe("Test DatabaseCreateService‚", function () {
var DatabaseCreateService,cordovaSQLite,ionicPlatform,rootScope,q;
var db=null;
beforeEach(module("starter.services"));
beforeEach(module("ngCordova"));
beforeEach(module("ionic"));
beforeEach(inject(function (_DatabaseCreateService_, $cordovaSQLite,$ionicPlatform,$rootScope,$q) {
DatabaseCreateService = _DatabaseCreateService_;
cordovaSQLite = $cordovaSQLite;
ionicPlatform = $ionicPlatform;
q = $q;
rootScope = $rootScope;
ionicPlatform.ready(function() {
db = window.openDatabase("cgClientDB-Test.db", '1', 'my', 1024 * 1024 * 100);
});
}));
describe("Test DatabaseCreateService:createTableLocalValues", function() {
it("should check that the createTableLocalValues was called correctly and return correct data", function() {
var deferred = q.defer();
deferred.resolve(true);
spyOn(DatabaseCreateService,'createTableLocalValues').and.returnValue(deferred.promise);
var promise = DatabaseCreateService.createTableLocalValues(db);
expect(DatabaseCreateService.createTableLocalValues).toHaveBeenCalled();
expect(DatabaseCreateService.createTableLocalValues).toHaveBeenCalledWith(db);
expect(DatabaseCreateService.createTableLocalValues.calls.count()).toEqual(1);
promise.then(function(resp) {
expect(resp).not.toBe(undefined);
expect(resp).toBe(true);
},function(err) {
expect(err).not.toBe(true);
});
rootScope.$apply();
});
});
});
这个测试描述有效,但它没有 return 函数的值而不是它 return 在 deferred.resolve(true);
我想做的是调用 DatabaseCreateService.createTableLocalValues 函数并解析从函数中获取 return 的数据。
createTableLocalValues 函数是这样的:
var createTableLocalValues = function(db) {
var query = "CREATE TABLE IF NOT EXISTS `local_values` (" +
"`Key` TEXT PRIMARY KEY NOT NULL," +
"`Value` TEXT );";
return executeQuery(db,query,[],"Create cg_local_values");
};
好吧,如果我 运行 在浏览器或设备上使用此方法,如果一切正常并且 table 已创建,我将获得真正的支持。那么我如何在测试描述中也得到这个真实的真实而不是像我上面的例子中的假真实?
感谢您的帮助。
示例 2(使用 callThrough):
describe('my fancy thing', function () {
beforeEach(function() {
spyOn(DatabaseCreateService,'createTableSettings').and.callThrough();
});
it('should be extra fancy', function (done) {
var promise = DatabaseCreateService.createTableSettings(db);
rootScope.$digest();
promise.then(function(resp) {
console.log(resp);
expect(resp).toBeDefined();
expect(resp).toBe(true);
done();
},function(err) {
done();
});
});
});
在 karma 中记录消息-运行ner:
LOG: true
Chrome 46.0.2490 (Mac OS X 10.11.1) Test DatabaseCreateService‚ testing createTable functions: my fancy thing should be extra fancy FAILED
Error: Timeout - Async callback was not invoked within timeout specified by jasmine.DEFAULT_TIMEOUT_INTERVAL.
Chrome 46.0.2490 (Mac OS X 10.11.1):执行了 42 次,共 42 次(1 次失败)(8.453 秒/8.03 秒)
更新:
原来这个问题与$cordovaSQLite.executeQuery函数本身有关。不知何故,它没有承诺超时,这就是错误的原因。我把ng-cordova的execute函数改成了这个。 (希望此更改不会破坏任何工作)
execute: function (db, query, binding) {
var q = Q.defer();
db.transaction(function (tx) {
tx.executeSql(query, binding, function (tx, result) {
q.resolve(result);
},
function (transaction, error) {
q.reject(error);
});
});
return q.promise.timeout( 5000, "The execute request took too long to respond." );
}
有了这个改变,测试正确通过了!
你可以监视一个函数,并委托给实际的实现,使用
spyOn(DatabaseCreateService,'createTableLocalValues').and.callThrough();
您可能还需要在调用函数后调用 rootScope.$digest()
,这样 promise 才会解析。
编辑:
测试异步代码时,您应该使用 done
模式:
it('should be extra fancy', function (done) {
var promise = DatabaseCreateService.createTableSettings(db);
rootScope.$digest();
promise.then(function(resp) {
console.log(resp);
expect(resp).toBeDefined();
expect(resp).toBe(false);
expect(resp).toBe(true);
done();
});
});
关于您在测试中断言方式的建议:
在您的测试中,您正在对返回的承诺调用 then
以做出您的断言:
promise.then(function(resp) {
expect(resp).not.toBe(undefined);
expect(resp).toBe(true);
},function(err) {
expect(err).not.toBe(true);
});
这迫使您在错误函数中添加一个断言,这样如果承诺根本没有解决,您的测试仍然会失败。
请尝试使用 Jasmine Promise Matchers。它将使您的测试代码更易于阅读,并在测试失败时导致更清晰的错误消息。您的测试看起来像这样:
expect(promise).toBeResolvedWith(true);