docs(zh-cn): sync recent updates (#275)

* [docs][zh-cn] sync recent updates

* [docs][zh-cn] finished all translations

Author: Jinjiang

Diff for: docs/zh-cn/README.md

@@ -24,23 +24,25 @@
     - [attrs](api/options.md#attrs)
     - [listeners](api/options.md#listeners)
     - [clone](api/options.md#clone)
+    - [provide](api/options.md#provide)
+    - [其它选项](api/options.md#other-options)
   * [Wrapper](api/wrapper/README.md)
+    * [attributes](api/wrapper/attributes.md)
+    * [classes](api/wrapper/classes.md)
     * [contains](api/wrapper/contains.md)
     * [emitted](api/wrapper/emitted.md)
     * [emittedByOrder](api/wrapper/emittedByOrder.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper/destroy.md)
     * [find](api/wrapper/find.md)
     * [findAll](api/wrapper/findAll.md)
-    * [hasAttribute](api/wrapper/hasAttribute.md)
-    * [hasClass](api/wrapper/hasClass.md)
-    * [hasProp](api/wrapper/hasProp.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)
@@ -53,9 +55,6 @@
     * [contains](api/wrapper-array/contains.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper-array/destroy.md)
-    * [hasAttribute](api/wrapper-array/hasAttribute.md)
-    * [hasClass](api/wrapper-array/hasClass.md)
-    * [hasProp](api/wrapper-array/hasProp.md)
     * [hasStyle](api/wrapper-array/hasStyle.md)
     * [is](api/wrapper-array/is.md)
     * [isEmpty](api/wrapper-array/isEmpty.md)

Diff for: docs/zh-cn/SUMMARY.md

@@ -22,23 +22,25 @@
     - [attrs](api/options.md#attrs)
     - [listeners](api/options.md#listeners)
     - [clone](api/options.md#clone)
+    - [provide](api/options.md#provide)
+    - [其它选项](api/options.md#other-options)
   * [Wrapper](api/wrapper/README.md)
+    * [attributes](api/wrapper/attributes.md)
+    * [classes](api/wrapper/classes.md)
     * [contains](api/wrapper/contains.md)
     * [emitted](api/wrapper/emitted.md)
     * [emittedByOrder](api/wrapper/emittedByOrder.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper/destroy.md)
     * [find](api/wrapper/find.md)
     * [findAll](api/wrapper/findAll.md)
-    * [hasAttribute](api/wrapper/hasAttribute.md)
-    * [hasClass](api/wrapper/hasClass.md)
-    * [hasProp](api/wrapper/hasProp.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)
@@ -51,9 +53,6 @@
     * [contains](api/wrapper-array/contains.md)
     * [exists](api/wrapper/exists.md)
     * [destroy](api/wrapper-array/destroy.md)
-    * [hasAttribute](api/wrapper-array/hasAttribute.md)
-    * [hasClass](api/wrapper-array/hasClass.md)
-    * [hasProp](api/wrapper-array/hasProp.md)
     * [hasStyle](api/wrapper-array/hasStyle.md)
     * [is](api/wrapper-array/is.md)
     * [isEmpty](api/wrapper-array/isEmpty.md)

Diff for: docs/zh-cn/api/README.md

@@ -12,6 +12,8 @@
   - [attrs](./options.md#attrs)
   - [listeners](./options.md#listeners)
   - [clone](./options.md#clone)
+  - [provide](./options.md#provide)
+  - [其它选项](./options.md#other-options)
 * [Wrapper](./wrapper/README.md)
   * [contains](./wrapper/contains.md)
   * [emitted](./wrapper/emitted.md)
@@ -29,6 +31,7 @@
   * [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)
@@ -41,9 +44,6 @@
   * [contains](./wrapper-array/contains.md)
   * [exists](./wrapper/exists.md)
   * [destroy](./wrapper-array/destroy.md)
-  * [hasAttribute](./wrapper-array/hasAttribute.md)
-  * [hasClass](./wrapper-array/hasClass.md)
-  * [hasProp](./wrapper-array/hasProp.md)
   * [hasStyle](./wrapper-array/hasStyle.md)
   * [is](./wrapper-array/is.md)
   * [isEmpty](./wrapper-array/isEmpty.md)

Diff for: docs/zh-cn/api/config.md

@@ -12,6 +12,7 @@
   'transition-group': TransitionGroupStub
 }`
 
+存储在 `config.stubs` 中的存根会被默认使用。  
 用到的组件存根。它们会被传入挂载选项的 `stubs` 复写。
 
 当把 `stubs` 作为一个数组传入挂载选项时，`config.stubs` 会被转换为一个数组，然后用只返回一个 `<!---->` 的基础组件进行存根。

Diff for: docs/zh-cn/api/mount.md

@@ -122,8 +122,8 @@ import Faz from './Faz.vue'
 describe('Foo', () => {
   it('renders a div', () => {
     const wrapper = mount(Foo, {
-      stub: {
-        Bar: '<div class="stubbed />',
+      stubs: {
+        Bar: '<div class="stubbed" />',
         BarFoo: true,
         FooBar: Faz
       }

Diff for: docs/zh-cn/api/options.md

@@ -1,8 +1,6 @@
 # 挂载选项
 
-即 `mount` 和 `shallow` 的选项。该对象同时包含了 `vue-test-utils` 挂载选项和原始的 Vue 选项。
-
-Vue 选项会在一个新的实例被创建的时候传递给组件。比如 `store`、`propsData`。想查阅完整的列表，请移步 [Vue API 文档](https://cn.vuejs.org/v2/api/)。
+即 `mount` 和 `shallow` 的选项。该对象同时包含了 `vue-test-utils` 挂载选项和其它选项。
 
 ## `vue-test-utils` 特定的挂载选项
 
@@ -13,9 +11,9 @@ Vue 选项会在一个新的实例被创建的时候传递给组件。比如 `st
 - [`localVue`](#localvue)
 - [`attachToDocument`](#attachtodocument)
 - [`attrs`](#attrs)
-- [`provide`](#provide)
 - [`listeners`](#listeners)
 - [`clone`](#clone)
+- [`provide`](#provide)
 
 ### `context`
 
@@ -26,9 +24,13 @@ Vue 选项会在一个新的实例被创建的时候传递给组件。比如 `st
 示例：
 
 ```js
+import Foo from './Foo.vue'
+import Bar from './Bar.vue'
+
 const wrapper = mount(Component, {
   context: {
-    props: { show: true }
+    props: { show: true },
+    children: [Foo, Bar]
   }
 })
 
@@ -39,7 +41,7 @@ expect(wrapper.is(Component)).toBe(true)
 
 - 类型：`{ [name: string]: Array<Component>|Component|string }`
 
-为组件提供一个 slot 内容的对象。该对象中的键名就是相应的 slot 名，键值可以是一个组件、一个组件数组或一个字符串模板。
+为组件提供一个 slot 内容的对象。该对象中的键名就是相应的 slot 名，键值可以是一个组件、一个组件数组、一个字符串模板或文本。
 
 示例：
 
@@ -52,12 +54,33 @@ const wrapper = shallow(Component, {
   slots: {
     default: [Foo, Bar],
     fooBar: Foo, // 将会匹配 `<slot name="FooBar" />`。
-    foo: '<div />'
+    foo: '<div />',
+    bar: 'bar'
   }
 })
 expect(wrapper.find('div')).toBe(true)
 ```
 
+#### 传递文本
+
+你可以传递文本到 `slots`。  
+这里有两处限制。
+
+这只在 Vue 2.2+ 及以上版本工作。
+
+下面的这段代码的文本可以工作。
+
+```js
+const wrapper = mount(ComponentWithSlots, { slots: { default: 'foobar' }})
+```
+
+下面的这段代码的文本则不可以工作。
+
+```js
+const wrapper1 = mount(ComponentWithSlots, { slots: { default: 'foo<span>bar</span>' }})
+const wrapper2 = mount(FooComponent, { slots: { default: 'foo {{ bar }}' }})
+```
+
 ### `stubs`
 
 - 类型：`{ [name: string]: Component | boolean } | Array<string>`
@@ -166,3 +189,33 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 - 类型：`Object`
 
 为组件传递用于注入的属性。可查阅 [provie/inject](https://cn.vuejs.org/v2/api/#provide-inject) 了解更多。
+
+## 其它选项
+
+当 `mount` 和 `shallow` 的选项包含了挂载选项之外的选项时，则会将它们通过[扩展](https://vuejs.org/v2/api/#extends)复写到其组件选项。
+
+```js
+const Component = {
+  template: '<div>{{ foo() }}{{ bar() }}{{ baz() }}</div>',
+  methods: {
+    foo () {
+      return 'a'
+    },
+    bar () {
+      return 'b'
+    }
+  }
+}
+const options = {
+  methods: {
+    bar () {
+      return 'B'
+    },
+    baz () {
+      return 'C'
+    }
+  }
+}
+const wrapper = mount(Component, options)
+expect(wrapper.text()).to.equal('aBC')
+```

Diff for: docs/zh-cn/api/shallow.md

@@ -6,13 +6,13 @@
   - `{Object} options`
     - `{boolean} attachToDocument`
     - `{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`
     - `{boolean} clone`
-    - `{Object} children`
     - `{Vue} localVue`
 
 - **返回值：**`{Wrapper}`

Diff for: docs/zh-cn/api/wrapper/attributes.md

@@ -0,0 +1,15 @@
+# `attributes()`
+
+返回 `Wrapper` DOM 节点的特性对象。
+
+- **返回值：**`{[attribute: string]: any}`
+
+- **示例：**
+
+```js
+import { mount } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = mount(Foo)
+expect(wrapper.attributes().id).toBe('foo')

Diff for: docs/zh-cn/api/wrapper/classes.md

@@ -0,0 +1,18 @@
+# `classes()`
+
+返回 `Wrapper` DOM 节点的 class。
+
+返回 class 名称的数组。
+
+- **返回值：**`Array<{string}>`
+
+- **示例：**
+
+```js
+import { mount } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = mount(Foo)
+expect(wrapper.classes()).toContain('bar')
+```

Diff for: docs/zh-cn/api/wrapper/emitted.md

@@ -44,3 +44,15 @@ expect(wrapper.emitted('foo').length).toBe(2)
 // 断言事件的有效数据
 expect(wrapper.emitted('foo')[1]).toEqual([123])
 ```
+
+该 `.emitted()` 方法每次被调用时都返回相同的对象，而不是返回一个新的，所以当新事件被触发时该对象会被更新：
+
+```js
+const emitted = wrapper.emitted()
+
+expect(emitted.foo.length).toBe(1)
+
+// 想办法让 `wrapper` 触发 "foo" 事件
+
+expect(emitted.foo.length).toBe(2)
+```

Diff for: docs/zh-cn/api/wrapper/hasProp.md

@@ -0,0 +1,22 @@
+# `props()`
+
+返回 `Wrapper` `vm` 的 props 对象。
+
+**注意：该包裹器必须包含一个 Vue 示例。**
+
+- **返回值：**`{[prop: string]: any}`
+
+- **示例：**
+
+```js
+import { mount } from 'vue-test-utils'
+import { expect } from 'chai'
+import Foo from './Foo.vue'
+
+const wrapper = mount(Foo, {
+  propsData: {
+    bar: 'baz'
+  }
+})
+expect(wrapper.props().bar).toBe('baz')
+```

Diff for: docs/zh-cn/api/wrapper/props.md

@@ -43,3 +43,4 @@ Vue 的单文件组件在它们运行于 Node 或浏览器之前是需要预编
 - [使用 Mocha 的示例工程](https://github.com/vuejs/vue-test-utils-mocha-webpack-example)
 - [使用 tape 的示例工程](https://github.com/eddyerburgh/vue-test-utils-tape-example)
 - [使用 AVA 的示例工程](https://github.com/eddyerburgh/vue-test-utils-ava-example)
+- [tyu - Delightful web testing by egoist](https://github.com/egoist/tyu)

Diff for: docs/zh-cn/guides/choosing-a-test-runner.md

@@ -189,7 +189,23 @@ describe('键盘事件测试', () => {
 
 点后面的按键名 `keydown.up` 会被翻译成一个 `keyCode`。这些被支持的按键名有：
 
-* `enter`, `tab`, `delete`, `esc`, `space`, `up`, `down`, `left`, `right`
+| key name | key code |
+| --- | --- |
+| enter | 13 |
+| esc | 27 |
+| tab | 9 |
+| space | 32 |
+| delete | 46 |
+| backspace | 8 |
+| insert | 45 |
+| up | 38 |
+| down | 40 |
+| left | 37 |
+| right | 39 |
+| end | 35 |
+| home | 36 |
+| pageup | 33 |
+| pagedown | 34 |
 
 ## 重要事项