[docs][zh-cn] synced updates

docs/zh-cn/README.md

@@ -2,13 +2,16 @@
 
 `vue-test-utils` 是 Vue.js 官方的单元测试实用工具库。
 
+## 目录
+
 * [教程](guides/README.md)
   * [起步](guides/getting-started.md)
   * [常用技巧](guides/common-tips.md)
   * [鼠标、键盘以及其它 DOM 事件](guides/dom-events.md)
   * [选择一个测试运行器](guides/choosing-a-test-runner.md)
   * [用 Jest 测试单文件组件](guides/testing-SFCs-with-jest.md)
   * [用 Mocha 和 webpack 测试单文件组件](guides/testing-SFCs-with-mocha-webpack.md)
+  * [用 Karma 测试单文件组件](guides/testing-SFCs-with-karma.md)
   * [测试异步行为](guides/testing-async-components.md)
   * [配合 Vue Router 使用](guides/using-with-vue-router.md)
   * [配合 Vuex 实用](guides/using-with-vuex.md)
@@ -36,35 +39,34 @@
     * [destroy](api/wrapper/destroy.md)
     * [find](api/wrapper/find.md)
     * [findAll](api/wrapper/findAll.md)
-    * [hasStyle](api/wrapper/hasStyle.md)
     * [html](api/wrapper/html.md)
     * [is](api/wrapper/is.md)
     * [isEmpty](api/wrapper/isEmpty.md)
     * [isVueInstance](api/wrapper/isVueInstance.md)
     * [name](api/wrapper/name.md)
     * [props](api/wrapper/props.md)
-    * [setComputed](api/wrapper/setComputed.md)
     * [setData](api/wrapper/setData.md)
     * [setMethods](api/wrapper/setMethods.md)
     * [setProps](api/wrapper/setProps.md)
     * [text](api/wrapper/text.md)
     * [trigger](api/wrapper/trigger.md)
     * [update](api/wrapper/update.md)
+    * [visible](api/wrapper/visible.md)
   * [WrapperArray](api/wrapper-array/README.md)
     * [at](api/wrapper-array/at.md)
     * [contains](api/wrapper-array/contains.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper-array/destroy.md)
-    * [hasStyle](api/wrapper-array/hasStyle.md)
+    * [filter](api/wrapper-array/filter.md)
     * [is](api/wrapper-array/is.md)
     * [isEmpty](api/wrapper-array/isEmpty.md)
     * [isVueInstance](api/wrapper-array/isVueInstance.md)
-    * [setComputed](api/wrapper-array/setComputed.md)
     * [setData](api/wrapper-array/setData.md)
     * [setMethods](api/wrapper-array/setMethods.md)
     * [setProps](api/wrapper-array/setProps.md)
     * [trigger](api/wrapper-array/trigger.md)
     * [update](api/wrapper-array/update.md)
+    * [visible](api/wrapper-array/visible.md)
   * [组件](api/components/README.md)
     * [TransitionStub](api/components/TransitionStub.md)
     * [TransitionGroupStub](api/components/TransitionGroupStub.md)

docs/zh-cn/SUMMARY.md

@@ -7,6 +7,7 @@
   * [选择一个测试运行器](guides/choosing-a-test-runner.md)
   * [用 Jest 测试单文件组件](guides/testing-SFCs-with-jest.md)
   * [用 Mocha 和 webpack 测试单文件组件](guides/testing-SFCs-with-mocha-webpack.md)
+  * [用 Karma 测试单文件组件](guides/testing-SFCs-with-karma.md)
   * [测试异步行为](guides/testing-async-components.md)
   * [配合 Vue Router 使用](guides/using-with-vue-router.md)
   * [配合 Vuex 使用](guides/using-with-vuex.md)
@@ -34,7 +35,6 @@
     * [destroy](api/wrapper/destroy.md)
     * [find](api/wrapper/find.md)
     * [findAll](api/wrapper/findAll.md)
-    * [hasStyle](api/wrapper/hasStyle.md)
     * [html](api/wrapper/html.md)
     * [is](api/wrapper/is.md)
     * [isEmpty](api/wrapper/isEmpty.md)
@@ -47,24 +47,26 @@
     * [text](api/wrapper/text.md)
     * [trigger](api/wrapper/trigger.md)
     * [update](api/wrapper/update.md)
+    * [visible](api/wrapper/visible.md)
   * [WrapperArray](api/wrapper-array/README.md)
     * [at](api/wrapper-array/at.md)
     * [contains](api/wrapper-array/contains.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper-array/destroy.md)
-    * [hasStyle](api/wrapper-array/hasStyle.md)
+    * [filter](api/wrapper-array/filter.md)
     * [is](api/wrapper-array/is.md)
     * [isEmpty](api/wrapper-array/isEmpty.md)
     * [isVueInstance](api/wrapper-array/isVueInstance.md)
-    * [setComputed](api/wrapper-array/setComputed.md)
     * [setData](api/wrapper-array/setData.md)
     * [setMethods](api/wrapper-array/setMethods.md)
     * [setProps](api/wrapper-array/setProps.md)
     * [trigger](api/wrapper-array/trigger.md)
     * [update](api/wrapper-array/update.md)
+    * [visible](api/wrapper-array/visible.md)
   * [组件](api/components/README.md)
     * [TransitionStub](api/components/TransitionStub.md)
     * [TransitionGroupStub](api/components/TransitionGroupStub.md)
+    * [RouterLinkStub](api/components/RouterLinkStub.md)
   * [选择器](api/selectors.md)
   * [createLocalVue](api/createLocalVue.md)
   * [配置](api/config.md)

docs/zh-cn/api/README.md

@@ -14,6 +14,8 @@
   - [provide](./options.md#provide)
   - [其它选项](./options.md#other-options)
 * [Wrapper](./wrapper/README.md)
+  * [attributes](./wrapper/attributes.md)
+  * [classes](./wrapper/classes.md)
   * [contains](./wrapper/contains.md)
   * [emitted](./wrapper/emitted.md)
   * [emittedByOrder](./wrapper/emittedByOrder.md)
@@ -24,35 +26,34 @@
   * [hasAttribute](./wrapper/hasAttribute.md)
   * [hasClass](./wrapper/hasClass.md)
   * [hasProp](./wrapper/hasProp.md)
-  * [hasStyle](./wrapper/hasStyle.md)
   * [html](./wrapper/html.md)
   * [is](./wrapper/is.md)
   * [isEmpty](./wrapper/isEmpty.md)
   * [isVueInstance](./wrapper/isVueInstance.md)
   * [name](./wrapper/name.md)
   * [props](./wrapper/props.md)
-  * [setComputed](./wrapper/setComputed.md)
   * [setData](./wrapper/setData.md)
   * [setMethods](./wrapper/setMethods.md)
   * [setProps](./wrapper/setProps.md)
   * [text](./wrapper/text.md)
   * [trigger](./wrapper/trigger.md)
   * [update](./wrapper/update.md)
+  * [visible](./wrapper/visible.md)
 * [WrapperArray](./wrapper-array/README.md)
   * [at](./wrapper-array/at.md)
   * [contains](./wrapper-array/contains.md)
   * [exists](./wrapper/exists.md)
   * [destroy](./wrapper-array/destroy.md)
-  * [hasStyle](./wrapper-array/hasStyle.md)
+  * [filter](./wrapper-array/filter.md)
   * [is](./wrapper-array/is.md)
   * [isEmpty](./wrapper-array/isEmpty.md)
   * [isVueInstance](./wrapper-array/isVueInstance.md)
-  * [setComputed](./wrapper-array/setComputed.md)
   * [setData](./wrapper-array/setData.md)
   * [setMethods](./wrapper-array/setMethods.md)
   * [setProps](./wrapper-array/setProps.md)
   * [trigger](./wrapper-array/trigger.md)
   * [update](./wrapper-array/update.md)
+  * [visible](./wrapper-array/visible.md)
 * [组件](./components/README.md)
   * [TransitionStub](./components/TransitionStub.md)
   * [TransitionGroupStub](./components/TransitionGroupStub.md)

docs/zh-cn/api/components/RouterLinkStub.md

@@ -0,0 +1,20 @@
+# `RouterLinkStub`
+
+一个用来存根 Vue Router 中 `router-link` 组件的组件。
+
+你可以在渲染树中使用这个组件查找一个 `router-link` 组件。
+
+- **用法：**
+
+在挂载选项中将其设置为一个存根：
+
+```js
+import { mount, RouterLinkStub } from '@vue/test-utils'
+
+const wrapper = mount(Component, {
+  stubs: {
+    RouterLink: RouterLinkStub
+  }
+})
+expect(wrapper.find(RouterLinkStub).props().to).toBe('/some/path')
+```

docs/zh-cn/api/wrapper-array/filter.md

@@ -0,0 +1,23 @@
+# `filter(predicate)`
+
+用一个针对 `Wrapper` 的断言函数过滤 `WrapperArray`。
+
+该方法的行为和 [Array.prototype.filter](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/filter) 相同。
+
+- **参数：**
+  - `{function} predicate`
+
+- **返回值：** `{WrapperArray}`
+
+一个新的 `WrapperArray` 实例，该实例包含了经过断言函数处理后返回真值的 `Wrapper` 实例。
+
+- **示例：**
+
+```js
+import { shallow } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = shallow(Foo)
+const filteredDivArray = wrapper.findAll('div').filter(w => !w.hasClass('filtered'))
+```

docs/zh-cn/api/wrapper-array/visible.md

@@ -0,0 +1,22 @@
+# `visible()`
+
+断言每个 `WrapperArray` 中的每个 `Wrapper` 是否可见。
+
+如果至少一个元素的祖先拥有 `display: none` 或 `visibility: hidden` 样式则返回 `false`。
+
+这可以用于断言一个组件是否被 `v-show` 所隐藏。
+
+- **返回值：** `{boolean}`
+
+- **示例：**
+
+```js
+import { mount } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = mount(Foo)
+expect(wrapper.visible()).toBe(true)
+expect(wrapper.findAll('.is-not-visible').visible()).toBe(false)
+expect(wrapper.findAll('.is-visible').visible()).toBe(true)
+```

docs/zh-cn/api/wrapper/visible.md

@@ -0,0 +1,21 @@
+# `visible()`
+
+断言 `Wrapper` 是否可见。
+
+如果有一个祖先元素拥有 `display: none` 或 `visibility: hidden` 样式则返回 `false`。
+
+这可以用于断言一个组件是否被 `v-show` 所隐藏。
+
+- **返回值：** `{boolean}`
+
+- **示例：**
+
+```js
+import { mount } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = mount(Foo)
+expect(wrapper.visible()).toBe(true)
+expect(wrapper.find('.is-not-visible').visible()).toBe(false)
+```

docs/zh-cn/guides/README.md

@@ -6,6 +6,7 @@
 * [选择一个测试运行器](./choosing-a-test-runner.md)
 * [用 Jest 测试单文件组件](./testing-SFCs-with-jest.md)
 * [用 Mocha 和 webpack 测试单文件组件](./testing-SFCs-with-mocha-webpack.md)
+* [用 Karma 测试单文件组件](./testing-SFCs-with-karma.md)
 * [测试异步行为](./testing-async-components.md)
 * [配合 Vue Router 使用](./using-with-vue-router.md)
 * [配合 Vuex 实用](./using-with-vuex.md)

docs/zh-cn/guides/common-tips.md

@@ -109,7 +109,7 @@ mount(Component, {
 })
 ```
 
-**注意有些插件会为全局的 Vue 构造函数添加只读属性，比如 Vue Router。这使得我们无法在一个 `localVue` 构造函数上二次安装该插件，或伪造这些属性。**
+**注意有些插件会为全局的 Vue 构造函数添加只读属性，比如 Vue Router。这使得我们无法在一个 `localVue` 构造函数上二次安装该插件，或伪造这些只读属性。**
 
 ## 仿造注入
 
@@ -135,3 +135,7 @@ mount(Component, {
 ## 处理路由
 
 因为路由需要在应用的全局结构中进行定义，且引入了很多组件，所以最好集成到 end-to-end 测试。对于依赖 `vue-router` 功能的独立的组件来说，你可以使用上面提到的技术仿造它们。
+
+## 探测样式
+
+当你的测试运行在 `jsdom` 中时，可以只探测到内联样式。

docs/zh-cn/guides/testing-SFCs-with-jest.md

@@ -11,7 +11,7 @@ Jest 是一个由 Facebook 开发的测试运行器，致力于提供一个“be
 我们要做的第一件事就是安装 Jest 和 `vue-test-utils`：
 
 ```bash
-$ npm install --save-dev jest vue-test-utils
+$ npm install --save-dev jest @vue/test-utils
 ```
 
 然后我们需要在 `package.json` 中定义一个单元测试的脚本。