docs: update docs/ja (#281)

* docs: update docs/ja

* Update README.md

* Update trigger.md

* Update trigger.md

Author: 38elements

docs/ja/README.md

@@ -25,6 +25,7 @@
     - [listeners](api/options.md#listeners)
     - [clone](api/options.md#clone)
     - [provide](api/options.md#provide)
+    - [その他のオプション](api/options.md#その他のオプション)
   * [Wrapper](api/wrapper/README.md)
     * [attributes](api/wrapper/attributes.md)
     * [classes](api/wrapper/classes.md)

docs/ja/SUMMARY.md

@@ -23,6 +23,7 @@
     - [listeners](api/options.md#listeners)
     - [clone](api/options.md#clone)
     - [provide](api/options.md#provide)
+    - [その他のオプション](api/options.md#その他のオプション)
   * [Wrapper](api/wrapper/README.md)
     * [attributes](api/wrapper/attributes.md)
     * [classes](api/wrapper/classes.md)

docs/ja/api/README.md

@@ -13,6 +13,7 @@
   - [listeners](./options.md#listeners)
   - [clone](./options.md#clone)
   - [provide](./options.md#provide)
+  - [その他のオプション](./options.md#その他のオプション)
 * [Wrapper](./wrapper/README.md)
   * [attributes](./wrapper/attributes.md)
   * [classes](./wrapper/classes.md)

docs/ja/api/options.md

@@ -1,8 +1,6 @@
 # マウンティングオプション
 
-`mount` と `shallow` に対するオプション。オプションオブジェクトには、`vue-test-utils` のマウントオプションと生の Vue オプションの両方を含めることができます。
-
-新しくインスタンスが作成されると、Vue オプションがコンポーネントに渡されます。例: `store`、 `propsData` など。完全なリストについては [Vue API ドキュメント](https://jp.vuejs.org/v2/api/)を参照してください。
+`mount` と `shallow` に対するオプション。オプションオブジェクトには、`vue-test-utils` のマウントオプションとその他のオプションを含めることができます。
 
 ## `vue-test-utils` の詳細なマウンティングオプション
 
@@ -58,6 +56,12 @@ const wrapper = shallow(Component, {
 expect(wrapper.find('div')).toBe(true)
 ```
 
+#### テキストを渡す
+
+テキストを値として `slots` に渡すことはできますが、1つ制限事項があります。  
+PhantomJS をサポートしません。  
+[Puppeteer](https://github.com/karma-runner/karma-chrome-launcher#headless-chromium-with-puppeteer)を使用してください。
+
 ### `stubs`
 
 - type: `{ [name: string]: Component | boolean } | Array<string>`
@@ -171,3 +175,33 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 - 型: `Object`
 
 コンポーネントに指定したプロパティを注入します。[provide/inject](https://vuejs.org/v2/api/#provide-inject) を参照してください。
+
+## その他のオプション
+
+`mount` と `shallow` にマウンティングオプション以外のオプションが渡されると、コンポーネントのオプションは [extends](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')
+```

docs/ja/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} intercept`
+    - `{Object} mocks`
     - `{Object|Array<string>} stubs`
     - `{boolean} clone`
-    - `{Object} children`
     - `{Vue} localVue`
 
 - **戻り値:** `{Wrapper}`

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

@@ -4,6 +4,7 @@
 
 - **プロパティ:**
 
+`wrappers` `array`: `WrapperArray` に含まれる `Wrappers`  
 `length` `number`: `WrapperArray` に含まれる `Wrappers` の数
 
  - **メソッド:**

docs/ja/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 イベントを emit する何らかの処理したとします。
+
+expect(emitted.foo.length).toBe(2)
+```

docs/ja/api/wrapper/props.md

@@ -9,12 +9,15 @@
 - **例:**
 
 ```js
-import { mount } from 'vue-test-utils'
-import { expect } from 'chai'
 import Foo from './Foo.vue'
+import Bar from './Bar.vue'
 
-const wrapper = mount(Foo, {
-  propsData: 'baz'
+const wrapper = mount(Component, {
+  context: {
+    props: { show: true },
+    children: [Foo, Bar]
+  }
 })
-expect(wrapper.props().bar).toBe('baz')
+
+expect(wrapper.is(Component)).toBe(true)
 ```

docs/ja/api/wrapper/trigger.md

@@ -36,3 +36,15 @@ wrapper.trigger('click', {
 
 expect(clickHandler.called).toBe(true)
 ```
+
+- **イベントターゲットの設定:**
+
+`trigger` は `Event` オブジェクトを生成して、Wrapper.element にイベントを送ります。  
+`Event` オブジェクトの `target` 値を編集できません。つまり、 `target` を オプションオブジェクトにセットすることはできません。  
+`target` の属性を追加するには、 `trigger` を実行する前に Wrapper.element の属性にその値をセットする必要があります。  
+
+```js
+const input = wrapper.find('input')
+input.element.value = 100
+input.trigger('click')
+```