概述
最近在进行angular单元测试在组件初始化渲染方面的测试,使用的是RxJS提供的弹珠测试来模拟http请求延迟。
但是在某些编辑组件中,ngOnInit方法中使用了router来获取路由参数。在单元测试中,组件不会接收真的路由参数,因此并没有接收到测试数据,初始化时,渲染的组件是空数据。
本文的目的,是通过手动发送路由参数,来使组件成功获取测试数据。
本文使用的技术基于:angularu在单元测试中如何模拟HTTP请求延迟
问题复现
在未出现问题的情况下,当我们为服务层设置好测试桩、在测试文件中模拟好返回值之后,启动测试之后,组件会正常渲染,并且会填入模拟返回的随机数据。
如果在断言非空的语句Assert.isDefined后面加入console.log,控制台可以输出字符串。
如下:
然而,在后来测试的这几个组件中,按照示例代码写完、测试之后,渲染的组件并没有模拟数据,而是空组件。
虽然测试也能通过,但通过是因为断言的代码根本没有执行,代码中加入console.log,控制台没有输出。如下:
尽管在这种情况下,单元测试也能通过,但事实上,由于根本没有接收到返回值,我们无法验证服务层的返回值是否正确,这种做法对项目来说,是不负责任的,这增大了生产环境出错的风险。
问题分析
先上组件的ngOnInit初始化代码:
ngOnInit() {
this.getEditCollege();
}
/**
* 获取要编辑的学院
*/
public getEditCollege() {
// 发起订阅,获取路由参数,获得参数后执行回调
this.route.params.subscribe((params: {id: number}) => {
console.log("subscribe");
this.collegeService.getCollegeById(params.id).subscribe((data) => {
Assert.isDefined(data.id, 'id');
Assert.isDefined(data.name, 'name');
Assert.isDefined(data.code, 'code');
Assert.isDefined(data.number, 'number');
console.log("college->edit");
this.initForm(data);
});
});
}
通过归纳发现,所有出错的组件都有用route获取路由参数的过程:发起订阅,当结果返回时执行回调方法,向服务层获取对象。
用打断点的方式得出结论,route发起的订阅根本没有返回,因此后面的回调方法也就没有执行。
因为route是通过路由的变化,来获取参数路由参数的,但在单元测试中,路由并不会发生变化。
所以需要用一个假的ActiveRouteStub来代替真的ActiveRoute完成单元测试。
ActiveRouteStub
/**
* ActiveRouteStub
* 路由功能服务桩
*/
import { Observable, Subject } from 'rxjs';
export class ActivatedRouteStub {
paramsSubject = new Subject();
params: Observable;
parent: any;
snapshot = {
paramMap: {
get: () => {
return 0;
}
}
};
constructor() {
this.params = this.paramsSubject.asObservable();
}
}
然后从Provider引入(也可以引入到单元测试专用的辅助模块中,例如ServiceTestingModule):
providers: [
{provide: ActivatedRoute, useClass: ActivatedRouteStub}
]
在测试类中改变路由参数
接下来通过代码,收到改变路,传入和组件接收的类型相对应的参数(示例组件中使用ID):
it('should create', fakeAsync(() => {
// 字段断言,调用getCollegeById
expect(component).toBeTruthy();
// 尝试获取真的,实际上获取的假的
const route = TestBed.get(ActivatedRoute) as ActivatedRouteStub;
// 发送路由参数,参数为要编辑的对象的ID
route.paramsSubject.next({id: randomNumber()});
}));
效果
这样,因为route发起的订阅有了返回值,回调方法被执行,所以被测组件就能获得测试数据。
只有当测试数据真真切切的被填入组件中,我们才能断定这个组件的初始化确实是正常的。
总结
单元测试中,我们尝尝使用RxJS提供的弹珠测试来模拟http请求延迟,由于route需要检测路由变化来获取参数,而单元测试中组件的路由不会发生变化,因此会造成订阅无法返回的情况,进而导致测试时的组件渲染不正常。
解决办法就是使用ActiveRouteStub代替ActiveRoute完成测试,手动设置路由变化,以便后面的代码正常执行,使得被测组件可以获取到随机的测试数据,进而成功渲染。