详解Vue单元测试case写法

书接上文,karma+webpack搭建vue单元测试环境介绍了vue单元测试环境搭建及查看源文件的测试覆盖覆盖率。今天来说一下vue单元测试思路和case的写法。测试框架使用jasmine,语法参考

代码地址:https://github.com/MarxJiao/vue-karma-test/tree/spec-demo

测试关注点

对于vue组件,单元测试测试主要关注以下几点:

  1. vue组件加载后,各数据模型是否符合预期
  2. 定义的方法是否可用
  3. filter是否可用
  4. 带有props的组件,数据能否正常传递
  5. 异步更新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单元测试环境

Vue官网单元测试介绍

Jasmine introduction

相关推荐