docs(zh): keep update (#662)

Author: Jinjiang

docs/zh/README.md

@@ -1,4 +1,4 @@
-# Vue Test Utils
+# 介绍
 
 Vue Test Utils 是 Vue.js 官方的单元测试实用工具库。
 

docs/zh/SUMMARY.md

@@ -6,4 +6,4 @@
 !!!include(docs/zh/api/renderToString.md)!!!
 !!!include(docs/zh/api/selectors.md)!!!
 !!!include(docs/zh/api/createLocalVue.md)!!!
-!!!include(docs/zh/api/config.md)!!!
+!!!include(docs/zh/api/config.md)!!!

docs/zh/api/README.md

@@ -2,6 +2,8 @@
 
 Vue Test Utils 包含了一个定义其选项的配置对象。
 
+### Vue Test Utils 配置选项
+
 ### `stubs`
 
 - 类型：`Object`
@@ -13,7 +15,7 @@ Vue Test Utils 包含了一个定义其选项的配置对象。
 存储在 `config.stubs` 中的存根会被默认使用。  
 用到的组件存根。它们会被传入挂载选项的 `stubs` 覆写。
 
-当把 `stubs` 作为一个数组传入挂载选项时，`config.stubs` 会被转换为一个数组，然后用只返回一个 `<!---->` 的基础组件进行存根。
+当把 `stubs` 作为一个数组传入挂载选项时，`config.stubs` 会被转换为一个数组，然后用只返回一个 `<${component name}-stub>` 的基础组件进行存根。
 
 示例：
 
@@ -77,3 +79,18 @@ VueTestUtils.config.provide['$logger'] = {
   }
 }
 ```
+
+### `logModifiedComponents`
+
+- 类型：`Boolean`
+- 默认值：`true`
+
+当被展开的子元素被自动化存根的时候记录下告警日志。设置为 `false` 时则会隐藏告警日志。和其它配置选项不同的是，它不能设置在挂载选项上。
+
+示例：
+
+```js
+import VueTestUtils from '@vue/test-utils'
+
+VueTestUtils.config.logModifiedComponents = false
+```

docs/zh/api/config.md

@@ -10,17 +10,17 @@
 可通过 `options.localVue` 来使用：
 
 ```js
-import { createLocalVue, shallow } from '@vue/test-utils'
+import { createLocalVue, shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
 
 const localVue = createLocalVue()
-const wrapper = shallow(Foo, {
+const wrapper = shallowMount(Foo, {
   localVue,
   mocks: { foo: true }
 })
 expect(wrapper.vm.foo).toBe(true)
 
-const freshWrapper = shallow(Foo)
+const freshWrapper = shallowMount(Foo)
 expect(freshWrapper.vm.foo).toBe(false)
 ```
 

docs/zh/api/createLocalVue.md

@@ -1,6 +1,6 @@
 # 挂载选项
 
-即 `mount` 和 `shallow` 的选项。该对象同时包含了 Vue Test Utils 挂载选项和其它选项。
+即 `mount` 和 `shallowMount` 的选项。该对象同时包含了 Vue Test Utils 挂载选项和其它选项。
 
 - [`context`](#context)
 - [`slots`](#slots)
@@ -48,7 +48,7 @@ expect(wrapper.is(Component)).toBe(true)
 import Foo from './Foo.vue'
 import Bar from './Bar.vue'
 
-const wrapper = shallow(Component, {
+const wrapper = shallowMount(Component, {
   slots: {
     default: [Foo, Bar],
     fooBar: Foo, // 将会匹配 `<slot name="FooBar" />`。
@@ -86,7 +86,7 @@ There are three limitations.
 示例：
 
 ```js
-const wrapper = shallow(Component, {
+const wrapper = shallowMount(Component, {
   scopedSlots: {
     foo: '<p slot-scope="props">{{props.index}},{{props.text}}</p>'
   }
@@ -98,7 +98,7 @@ expect(wrapper.find('#fooWrapper').html()).toBe('<div id="fooWrapper"><p>0,text1
 
 - 类型：`{ [name: string]: Component | boolean } | Array<string>`
 
-将子组件存根。可以是一个要存根的组件名的数组或对象。如果 `stubs` 是一个数组，则每个存根都是一个 `<!---->`。
+将子组件存根。可以是一个要存根的组件名的数组或对象。如果 `stubs` 是一个数组，则每个存根都是一个 `<${component name}-stub>`。
 
 示例：
 
@@ -109,7 +109,7 @@ mount(Component, {
   stubs: ['registered-component']
 })
 
-shallow(Component, {
+shallowMount(Component, {
   stubs: {
     // 使用一个特定的实现作为存根
     'registered-component': Foo,
@@ -129,7 +129,7 @@ shallow(Component, {
 
 ```js
 const $route = { path: 'http://www.example-path.com' }
-const wrapper = shallow(Component, {
+const wrapper = shallowMount(Component, {
   mocks: {
     $route
   }
@@ -198,14 +198,12 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 - 类型：`boolean`
 - 默认值：`true`
 
-将所有的侦听器都设置为同步执行。
-
 当 `sync` 是 `true` 时，这个 Vue 组件会被同步渲染。  
 当 `sync` 是 `false` 时，这个 Vue 组件会被异步渲染。
 
 ## 其它选项
 
-当 `mount` 和 `shallow` 的选项包含了挂载选项之外的选项时，则会将它们通过[扩展](https://vuejs.org/v2/api/#extends)覆写到其组件选项。
+当 `mount` 和 `shallowMount` 的选项包含了挂载选项之外的选项时，则会将它们通过[扩展](https://vuejs.org/v2/api/#extends)覆写到其组件选项。
 
 ```js
 const Component = {

docs/zh/api/options.md

@@ -32,10 +32,10 @@ export default {
 ```
 
 ```js
-import { shallow } from '@vue/test-utils'
+import { shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
 
-const wrapper = shallow(Foo)
+const wrapper = shallowMount(Foo)
 expect(wrapper.is(Foo)).toBe(true)
 ```
 

docs/zh/api/selectors.md

@@ -2,17 +2,17 @@
 
 一个 `WrapperArray` 是一个包含 [`Wrapper`](../wrapper/README.md) 数组以及 `Wrapper` 的测试方法等对象。
 
-- **属性：**
+## 属性
 
 ### `wrappers` 
 
 `array`: 包含在 `WrapperArray` 内的 `Wrappers`  
 
-###`length` 
+### `length` 
 
 `number`：该 `WrapperArray` 中包含的 `Wrapper` 的数量。
 
- - **方法：**
+## 方法
 
 !!!include(docs/zh/api/wrapper-array/at.md)!!!
 !!!include(docs/zh/api/wrapper-array/contains.md)!!!
@@ -24,4 +24,4 @@
 !!!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/trigger.md)!!!
+!!!include(docs/zh/api/wrapper-array/trigger.md)!!!

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

@@ -10,10 +10,10 @@
 - **示例：**
 
 ```js
-import { shallow } from '@vue/test-utils'
+import { shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
 
-const wrapper = shallow(Foo)
+const wrapper = shallowMount(Foo)
 const divArray = wrapper.findAll('div')
 const secondDiv = divArray.at(1)
 expect(secondDiv.is('p')).toBe(true)

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

@@ -12,11 +12,11 @@
 - **示例：**
 
 ```js
-import { shallow } from '@vue/test-utils'
+import { shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
 import Bar from './Bar.vue'
 
-const wrapper = shallow(Foo)
+const wrapper = shallowMount(Foo)
 const divArray = wrapper.findAll('div')
 expect(divArray.contains('p')).toBe(true)
 expect(divArray.contains(Bar)).toBe(true)