docs(zh-cn): synced updates (#512)

Author: Jinjiang

docs/zh-cn/README.md

@@ -18,6 +18,7 @@ Vue Test Utils 是 Vue.js 官方的单元测试实用工具库。
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [render](api/render.md)
   * [renderToString](api/renderToString.md)
   * [挂载选项](api/options.md)
     - [context](api/options.md#context)
@@ -29,6 +30,7 @@ Vue Test Utils 是 Vue.js 官方的单元测试实用工具库。
     - [attrs](api/options.md#attrs)
     - [listeners](api/options.md#listeners)
     - [provide](api/options.md#provide)
+    - [sync](api/options.md#sync)
     - [其它选项](api/options.md#other-options)
   * [Wrapper](api/wrapper/README.md)
     * [attributes](api/wrapper/attributes.md)

docs/zh-cn/SUMMARY.md

@@ -14,6 +14,7 @@
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [render](api/render.md)
   * [renderToString](api/renderToString.md)
   * [挂载选项](api/options.md)
     - [context](api/options.md#context)
@@ -25,6 +26,7 @@
     - [attrs](api/options.md#attrs)
     - [listeners](api/options.md#listeners)
     - [provide](api/options.md#provide)
+    - [sync](api/options.md#sync)
     - [其它选项](api/options.md#other-options)
   * [Wrapper](api/wrapper/README.md)
     * [attributes](api/wrapper/attributes.md)

docs/zh-cn/api/README.md

@@ -2,6 +2,7 @@
 
 * [mount](./mount.md)
 * [shallow](./shallow.md)
+* [render](./render.md)
 * [renderToString](./renderToString.md)
 * [挂载选项](./options.md)
   - [context](./options.md#context)
@@ -13,6 +14,7 @@
   - [attrs](./options.md#attrs)
   - [listeners](./options.md#listeners)
   - [provide](./options.md#provide)
+  - [sync](./options.md#sync)
   - [其它选项](./options.md#other-options)
 * [Wrapper](./wrapper/README.md)
   * [attributes](./wrapper/attributes.md)

docs/zh-cn/api/options.md

@@ -174,6 +174,9 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 
 将所有的侦听器都设置为同步执行。
 
+当 `sync` 是 `true` 时，这个 Vue 组件会被同步渲染。  
+当 `sync` 是 `false` 时，这个 Vue 组件会被异步渲染。
+
 ## 其它选项
 
 当 `mount` 和 `shallow` 的选项包含了挂载选项之外的选项时，则会将它们通过[扩展](https://vuejs.org/v2/api/#extends)覆写到其组件选项。

docs/zh-cn/api/render.md

@@ -0,0 +1,103 @@
+# `render(component {, options}])`
+
+- **参数：**
+
+  - `{Component} component`
+  - `{Object} options`
+    - `{Object} context`
+      - `{Array<Component|Object>|Component} children`
+    - `{Object} slots`
+        - `{Array<Componet|Object>|Component|String} default`
+        - `{Array<Componet|Object>|Component|String} named`
+    - `{Object} mocks`
+    - `{Object|Array<string>} stubs`
+    - `{Vue} localVue`
+
+- **返回值：** `{CheerioWrapper}`
+
+- **选项：**
+
+查阅[挂载选项](./options.md)
+
+- **使用：**
+
+将一个对象渲染成为一个字符串并返回一个 [cheerio 包裹器](https://github.com/cheeriojs/cheerio)。
+
+Cheerio 是一个类似 jQuery 的库，可以在 Node.js 中游览 DOM 对象。它的 API 和 Vue Test Utils 的 [`Wrapper`](wrapper/README.md) 类似。
+
+`render` 在底层使用 [`vue-server-renderer`](https://ssr.vuejs.org/zh/basic.html) 将一个组件渲染为静态的 HTML。
+
+`render` 被包含在了 `@vue/server-test-utils` 包之中。
+
+**不带选项：**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo)
+    expect(wrapper.text()).toContain('<div></div>')
+  })
+})
+```
+
+**带 Vue 选项：**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo, {
+      propsData: {
+        color: 'red'
+      }
+    })
+    expect(wrapper.text()).toContain('red')
+  })
+})
+```
+
+**默认插槽和具名插槽：**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+import Bar from './Bar.vue'
+import FooBar from './FooBar.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo, {
+      slots: {
+        default: [Bar, FooBar],
+        fooBar: FooBar, // Will match <slot name="FooBar" />,
+        foo: '<div />'
+      }
+    })
+    expect(wrapper.text()).toContain('<div></div>')
+  })
+})
+```
+
+**全局属性存根：**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const $route = { path: 'http://www.example-path.com' }
+    const wrapper = render(Foo, {
+      mocks: {
+        $route
+      }
+    })
+    expect(wrapper.text()).toContain($route.path)
+  })
+})
+```

docs/zh-cn/api/renderToString.md

@@ -23,12 +23,12 @@
 
 将一个组件渲染为 HTML。
 
-`renderToString` 在底层使用了 [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) 来将一个组件渲染为 HTML。
+`renderToString` 在底层使用 [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) 将一个组件渲染为 HTML。
 
 **不带选项：**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {
@@ -42,7 +42,7 @@ describe('Foo', () => {
 **带 Vue 选项：**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {
@@ -60,7 +60,7 @@ describe('Foo', () => {
 **默认插槽和具名插槽：**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 import Bar from './Bar.vue'
 import FooBar from './FooBar.vue'
@@ -82,7 +82,7 @@ describe('Foo', () => {
 **全局属性存根：**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {

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

@@ -48,13 +48,12 @@ npm install --save-dev vue-jest
     "transform": {
       // 用 `vue-jest` 处理 `*.vue` 文件
       ".*\\.(vue)$": "<rootDir>/node_modules/vue-jest"
-    },
-    "mapCoverage": true
+    }
   }
 }
 ```
 
-> **注意：**`vue-jest` 目前并不支持 `vue-loader` 所有的功能，比如自定义块和样式加载。额外的，诸如代码分隔等 webpack 特有的功能也是不支持的。如果要使用它们，请阅读教程里的[用 Mocha + webpack 测试单文件组件](./testing-SFCs-with-mocha-webpack.md)。
+> **注意：**`vue-jest` 目前并不支持 `vue-loader` 所有的功能，比如自定义块和样式加载。额外的，诸如代码分隔等 webpack 特有的功能也是不支持的。如果要使用这些不支持的特性，你需要用 Mocha 取代 Jest 来运行你的测试，同时用 webpack 来编译你的组件。想知道如何起步，请阅读教程里的[用 Mocha + webpack 测试单文件组件](./testing-SFCs-with-mocha-webpack.md)。
 
 ## 处理 webpack 别名
 
@@ -158,7 +157,7 @@ Jest 推荐你在被测试代码的所在目录下创建一个 `__tests__` 目
 
 Jest 可以被用来生成多种格式的测试覆盖率报告。以下是一个简单的起步的例子：
 
-扩展你的 `jest` 配置 (通常在 `package.json` 或 `jest.config.js` 中) 的 [`collectCoverage`](https://facebook.github.io/jest/docs/en/configuration.html#collectcoverage-boolean) 选项，然后添加 [`collectCoverageFrom`](https://facebook.github.io/jest/docs/en/configuration.html#collectcoveragefrom-array) 数组来定义需要收集测试覆盖率信息的文件。你还需要设置 [`mapCoverage`](https://facebook.github.io/jest/docs/en/configuration.html#mapcoverage-boolean) 为 `true`，以确保测试覆盖率数据的精准。
+扩展你的 `jest` 配置 (通常在 `package.json` 或 `jest.config.js` 中) 的 [`collectCoverage`](https://facebook.github.io/jest/docs/en/configuration.html#collectcoverage-boolean) 选项，然后添加 [`collectCoverageFrom`](https://facebook.github.io/jest/docs/en/configuration.html#collectcoveragefrom-array) 数组来定义需要收集测试覆盖率信息的文件。
 
 ```json
 {
@@ -168,8 +167,7 @@ Jest 可以被用来生成多种格式的测试覆盖率报告。以下是一个
     "collectCoverageFrom": [
       "**/*.{js,vue}",
       "!**/node_modules/**"
-    ],
-    "mapCoverage": true
+    ]
   }
 }
 ```

docs/zh-cn/guides/using-with-vuex.md

@@ -265,7 +265,7 @@ describe('Modules.vue', () => {
 
 这里有两个测试 Vuex store 的方式。第一个方式是分别单元化测试 getter、mutation 和 action。第二个方式是创建一个 store 并针对其进行测试。我们接下来看看这两种方式如何。
 
-为了弄清楚如果测试一个 Vuex store，我们会创建一个简单的计数器 store。该 store 会有一个 `increment` mutation 和一个 `counter` getter。
+为了弄清楚如果测试一个 Vuex store，我们会创建一个简单的计数器 store。该 store 会有一个 `increment` mutation 和一个 `evenOrOdd` getter。
 
 ```js
 // mutations.js
@@ -322,7 +322,7 @@ test('evenOrOdd returns even if state.count is even', () => {
   expect(getters.evenOrOdd(state)).toBe('even')
 })
 
-test('evenOrOdd returns odd if state.count is even', () => {
+test('evenOrOdd returns odd if state.count is odd', () => {
   const state = {
     count: 1
   }