详解Vue单元测试case写法
书接上文,karma+webpack搭建vue单元测试环境介绍了vue单元测试环境搭建及查看源文件的测试覆盖覆盖率。今天来说一下vue单元测试思路和case的写法。测试框架使用jasmine,语法参考。
代码地址:https://github.com/MarxJiao/vue-karma-test/tree/spec-demo
测试关注点
对于vue组件,单元测试测试主要关注以下几点:
- vue组件加载后,各数据模型是否符合预期
- 定义的方法是否可用
- filter是否可用
- 带有props的组件,数据能否正常传递
- 异步更新DOM的情况
组件加载后的状态
要测试组件加载后的状态,首先我们需要将vue组件生成实例。并检测挂载后实例的数据状态。下面是个示例:
我们来看下src/app.vue
组件的代码:
<template> <div> <h1>{{title}}</h1> <vc-message :message="message"></vc-message> </div> </template> <script> import child from './components/child.vue' export default { data() { return { title: '标题', message: '这是子组件' } }, components: { 'vc-message': child }, mounted() { this.title = 'Hello world' }, methods: { setMessage(msg) { this.message = msg; } } } </script>
组件加载后title的值应该变成'Hello world',所以我们这样来写测试代码
// 引用vue import Vue from 'vue'; // 引用要测试的组件 import app from '../../src/app.vue'; // 描述要测试的内容 describe('test app.vue', () => { // 描述要测试的最小单元 it('组件加载后,title应该是Holle world', () => { // 这里将app生成vue实例,并使用 $mount() 模拟挂载状态 let vm = new Vue(app).$mount(); // 断言组件的title是否变为了'Hello world' expect(vm.title).toEqual('Hello world'); }); });
执行karma start
我们能看到测试通过。
测试组件里面的方法
我们知道vue将data和methods都挂在了vue实例的根节点下,所以测试vue组件中的方法也和上面测试状态一样,直接调用vm的方法就行了。我们来测试以下setMessage方法:
// 引用vue import Vue from 'vue'; // 引用要测试的组件 import app from '../../src/app.vue'; // 描述要测试的内容 describe('test app.vue', () => { // 描述要测试的最小单元 it('设置message为『你好世界』', () => { // 这里将app生成vue实例,并使用 $mount() 模拟挂载状态 let vm = new Vue(app).$mount(); // 执行setMessage方法 vm.setMessage('你好世界'); // 断言组件的message是否变为了'你好世界' expect(vm.message).toEqual('你好世界'); }); });
执行karma start,就会看到测试成功。如果刚才没有关闭karma的话,在watch模式下,测试会自动进行。
怎么样?有没有感觉vue单元测试非常简单,赶紧做起来吧。
filter测试
filter的测试就更简单了。filter就是纯函数,有固定的输入输出,我们只需要执行函数看预期结果就好了。我们为组件添加一个转换大写的filter:
<template> ... <h1>{{title | upperCase}}</h1> ... </template> <script> ... filters: { upperCase(str) { return str.toUpperCase(); } } ... </script>
测试这个filter
// 引用要测试的组件 import app from '../../src/app.vue'; // 描述要测试的内容 describe('test app.vue', () => { it('upperCase过滤器能把app转换为APP', () => { // vue 组件export出来的是个对象,我们直接用这个对象的属性和方发就能调用到要测试的filter let appStr = app.filters.upperCase('app'); // 断言组件的appStr是为'APP' expect(appStr).toEqual('APP'); }); })
props测试
props依赖父组件,这个怎么测试呢。我们来看下vue官方提供的方法
使用Vue.extend()将组件挂载Vue构造器上,用propsData加入props数据,之后new一个Vue实例,这样就生成了一个独立的带props的vm和前面的实例一样,可以进行各种测试。
我们的child组件:
<template> <div> <div>{{message}}</div> </div> </template> <script> export default { props: ['message'] } </script>
测试child组件
// 引用vue import Vue from 'vue'; // 引用要测试的组件 import child from '../../src/components/child.vue'; /** * 获取生成的vm * * @param {Object} Component 组件 * @param {Object} propsData props数据 * @return {Object} vue实例 */ function getRenderedVm (Component, propsData) { const Ctor = Vue.extend(Component) const vm = new Ctor({ propsData }).$mount() return vm } // 描述要测试的内容 describe('test child.vue', () => { // 描述要测试的最小单元 it('组件加载后,child组件的message应该是「这是子组件」', () => { let childvm = getRenderedVm(child, { message: '这是message' }); // 断言组件的child组件的props是否生效 expect(childvm.message).toEqual('这是message'); }); });
是不是so easy.
异步更新DOM的情况
异步更新DOM的情况,参考vue官网的示例
使用Vue.nextTick来查看异步数据更新后dom是否变化
// 引用vue import Vue from 'vue'; // 引用要测试的组件 import app from '../../src/app.vue'; // 描述要测试的内容 describe('test app.vue', () => { // 异步数据更新 it('数据更新后,视图应该改变', done => { // 这里将app生成vue实例,并使用 $mount() 模拟挂载状态 let vm = new Vue(app).$mount(); // 挂载后改变title vm.title = 'APP'; Vue.nextTick(() => { let title = vm.$el.getElementsByTagName('h1')[0] expect(title.textContent).toEqual('APP') done(); }) }); });
以上就是对vue组件单元测试的用例编写的介绍,例子举得比较简单,主要是介绍各种情况的测试方法。
相关链接
karma+webpack搭建vue单元测试环境