docs(zh): update (#848)

Author: Jinjiang

docs/zh/README.md

@@ -65,9 +65,11 @@ Vue Test Utils 是 Vue.js 官方的单元测试实用工具库。
     * [is](api/wrapper-array/is.md)
     * [isEmpty](api/wrapper-array/isEmpty.md)
     * [isVueInstance](api/wrapper-array/isVueInstance.md)
+    * [setChecked](api/wrapper-array/setChecked.md)
     * [setData](api/wrapper-array/setData.md)
     * [setMethods](api/wrapper-array/setMethods.md)
     * [setProps](api/wrapper-array/setProps.md)
+    * [setValue](api/wrapper-array/setValue.md)
     * [trigger](api/wrapper-array/trigger.md)
     * [isVisible](api/wrapper-array/isVisible.md)
   * [组件](api/components/)

docs/zh/api/config.md

@@ -6,7 +6,7 @@ Vue Test Utils 包含了一个定义其选项的配置对象。
 
 ### `stubs`
 
-- 类型：`Object`
+- 类型：`{ [name: string]: Component | boolean | string }`
 - 默认值：`{
   transition: TransitionStub,
   'transition-group': TransitionGroupStub
@@ -46,7 +46,7 @@ VueTestUtils.config.mocks['$store'] = {
 
 ### `methods`
 
-- 类型：`Object`
+- 类型：`{ [name: string]: Function }`
 - 默认值：`{}`
 
 你可以使用 `config` 对象配置默认的方法。它可以用于为组件注入方法的插件，例如 [VeeValidate](https://vee-validate.logaretm.com/)。你可以通过在挂载选项中传入 `methods` 来覆写 `config` 中的方法集合。
@@ -94,3 +94,18 @@ import VueTestUtils from '@vue/test-utils'
 
 VueTestUtils.config.logModifiedComponents = false
 ```
+
+### `silent`
+
+- 类型：`Boolean`
+- 默认值：`true`
+
+在组件的可观察内容 (如 props) 发生突变时，警告会被 Vue 阻止。当设置为 `false` 时，所有的警告都会出现在控制台中。这是一个 `Vue.config.silent` 的配置方式。
+
+示例；
+
+```js
+import VueTestUtils from '@vue/test-utils'
+
+VueTestUtils.config.silent = false
+```

docs/zh/api/options.md

@@ -11,6 +11,7 @@
 - [`attachToDocument`](#attachtodocument)
 - [`attrs`](#attrs)
 - [`listeners`](#listeners)
+- [`parentComponent`](#parentComponent)
 - [`provide`](#provide)
 - [`sync`](#sync)
 
@@ -106,7 +107,9 @@ shallowMount(Component, {
   stubs: {
     // 使用一个特定的实现作为存根
     'registered-component': Foo,
-    // 使用创建默认的实现作为存根
+    // 使用创建默认的实现作为存根。
+    // 这里默认存根的组件名是 `another-component`。
+    // 默认存根是 `<${the component name of default stub}-stub>`。
     'another-component': true
   }
 })
@@ -180,6 +183,23 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 
 设置组件实例的 `$listeners` 对象。
 
+## parentComponent
+
+- 类型：`Object`
+
+用来作为被挂载组件的父级组件。
+
+示例：
+
+```js
+import Foo from './Foo.vue'
+
+const wrapper = shallowMount(Component, {
+  parentComponent: Foo
+})
+expect(wrapper.vm.$parent.name).toBe('foo')
+```
+
 ## provide
 
 - 类型：`Object`

docs/zh/api/render.md

@@ -7,8 +7,8 @@
     - `{Object} context`
       - `{Array<Component|Object>|Component} children`
     - `{Object} slots`
-        - `{Array<Componet|Object>|Component|String} default`
-        - `{Array<Componet|Object>|Component|String} named`
+        - `{Array<Component|Object>|Component|String} default`
+        - `{Array<Component|Object>|Component|String} named`
     - `{Object} mocks`
     - `{Object|Array<string>} stubs`
     - `{Vue} localVue`

docs/zh/api/renderToString.md

@@ -7,8 +7,8 @@
     - `{Object} context`
       - `{Array<Component|Object>|Component} children`
     - `{Object} slots`
-        - `{Array<Componet|Object>|Component|String} default`
-        - `{Array<Componet|Object>|Component|String} named`
+        - `{Array<Component|Object>|Component|String} default`
+        - `{Array<Component|Object>|Component|String} named`
     - `{Object} mocks`
     - `{Object|Array<string>} stubs`
     - `{Vue} localVue`

docs/zh/api/wrapper-array/README.md

@@ -10,7 +10,7 @@
 
 ### `length`
 
-`number`：该 `WrapperArray` 中包含的 `Wrapper` 的数量。
+`number` (只读)：该 `WrapperArray` 中包含的 `Wrapper` 的数量。
 
 ## 方法
 
@@ -21,7 +21,9 @@
 !!!include(docs/zh/api/wrapper-array/is.md)!!!
 !!!include(docs/zh/api/wrapper-array/isEmpty.md)!!!
 !!!include(docs/zh/api/wrapper-array/isVueInstance.md)!!!
+!!!include(docs/zh/api/wrapper-array/setChecked.md)!!!
 !!!include(docs/zh/api/wrapper-array/setData.md)!!!
 !!!include(docs/zh/api/wrapper-array/setMethods.md)!!!
 !!!include(docs/zh/api/wrapper-array/setProps.md)!!!
+!!!include(docs/zh/api/wrapper-array/setValue.md)!!!
 !!!include(docs/zh/api/wrapper-array/trigger.md)!!!

docs/zh/api/wrapper-array/setChecked.md

@@ -0,0 +1,38 @@
+## setChecked(checked)
+
+该方法是接下来这段代码的别名：
+
+```js
+wrapperArray.wrappers.forEach(wrapper => wrapper.setChecked(checked))
+```
+
+- **参数：**
+  - `{Boolean} checked (default: true)`
+
+- **示例：**
+
+```js
+import { mount } from '@vue/test-utils'
+
+const wrapper = mount({
+  data () {
+    return {
+      t1: false,
+      t2: ''
+    }
+  },
+  template: `
+    <div>
+      <input type="checkbox" name="t1" class="foo" v-model="t1" />
+      <input type="radio" name="t2" class="foo" value="foo" v-model="t2"/>
+      <input type="radio" name="t2" class="bar" value="bar" v-model="t2"/>
+    </div>`
+})
+
+const wrapperArray = wrapper.findAll('.foo')
+expect(wrapper.vm.t1).to.equal(false)
+expect(wrapper.vm.t2).to.equal('')
+wrapperArray.setChecked()
+expect(wrapper.vm.t1).to.equal(true)
+expect(wrapper.vm.t2).to.equal('foo')
+```

docs/zh/api/wrapper-array/setData.md

@@ -1,6 +1,6 @@
 ## setData(data)
 
-为 `WrapperArray` 的每个 `Wrapper` `vm` 都设置数据并强行更新。
+为 `WrapperArray` 的每个 `Wrapper` `vm` 都设置数据。
 
 **注意：该包裹器必须包含一个 Vue 示例。**
 

docs/zh/api/wrapper-array/setValue.md

@@ -0,0 +1,37 @@
+## setValue(value)
+
+该方法是接下来这段代码的别名：
+
+```js
+wrapperArray.wrappers.forEach(wrapper => wrapper.setValue(value))
+```
+
+- **参数：**
+  - `{any} value`
+
+- **示例：**
+
+```js
+import { mount } from '@vue/test-utils'
+
+const wrapper = mount({
+  data () {
+    return {
+      t1: '',
+      t2: ''
+    }
+  },
+  template: `
+    <div>
+      <input type="text" name="t1" class="foo" v-model="t1" />
+      <input type="text" name="t2" class="foo" v-model="t2"/>
+    </div>`
+})
+
+const wrapperArray = wrapper.findAll('.foo')
+expect(wrapper.vm.t1).to.equal('')
+expect(wrapper.vm.t2).to.equal('')
+wrapperArray.setValue('foo')
+expect(wrapper.vm.t1).to.equal('foo')
+expect(wrapper.vm.t2).to.equal('foo')
+```

docs/zh/api/wrapper/README.md

@@ -6,23 +6,23 @@ Vue Test Utils 是一个基于包裹器的 API。
 
 ## 属性
 
-### `vm` 
+### `vm`
 
-`Component`：这是该 Vue 实例。你可以通过 `wrapper.vm` 访问一个实例所有的[方法和属性](https://vuejs.org/v2/api/#Instance-Properties)。这只存在于 Vue 组件包裹器中。
+`Component` (只读)：这是该 Vue 实例。你可以通过 `wrapper.vm` 访问一个实例所有的[方法和属性](https://vuejs.org/v2/api/#Instance-Properties)。这只存在于 Vue 组件包裹器或绑定了 Vue 组件包裹器的 HTMLElement 中。
 
-### `element` 
+### `element`
 
-`HTMLElement`：包裹器的根 DOM 节点  
+`HTMLElement` (只读)：包裹器的根 DOM 节点
 
-### `options` 
+### `options`
 
-#### `options.attachedToDom` 
+#### `options.attachedToDom`
 
-`Boolean`：如果 `attachToDom` 传递给了 `mount` 或 `shallowMount` 则为真
+`Boolean` (只读)：如果 `attachToDom` 传递给了 `mount` 或 `shallowMount` 则为真
 
-#### `options.sync` 
+#### `options.sync`
 
-`Boolean`：如果挂载选项里的 `sync` 不是 `false` 则为真
+`Boolean` (只读)：如果挂载选项里的 `sync` 不是 `false` 则为真
 
 ## 方法