docs: add docs/ja/api/render.md (#490)

Author: 38elements

docs/ja/README.md

@@ -16,6 +16,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)

docs/ja/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)

docs/ja/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)

docs/ja/api/render.md

@@ -0,0 +1,104 @@
+# `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 wrapper](https://github.com/cheeriojs/cheerio) を返します。
+
+Cheerio は Node.js で jQuery のように DOM をスキャンするためのライブラリです。  
+これは Vue Test Utils の [`Wrapper`](wrapper/README.md) に似ているAPIを持っています。
+
+コンポーネントを静的なHTMLにレンダリングするために、`render` は内部で [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.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, // <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/ja/api/renderToString.md

@@ -25,10 +25,12 @@
 
 コンポーネントをHTMLにレンダリングするために、`renderToString` は内部で [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) を使用します。
 
+`renderToString` は `@vue/server-test-utils` パッケージに含まれています。
+
 **オプションなし:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {
@@ -42,7 +44,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 +62,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 +84,7 @@ describe('Foo', () => {
 **グローバルプロパティをスタブする:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {