docs: add docs/ja/api/renderToString.md (#446)

Author: 38elements

docs/ja/README.md

@@ -16,6 +16,7 @@
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [renderToString](api/renderToString.md)
   * [マウンティングオプション](api/options.md)
     - [context](api/options.md#context)
     - [slots](api/options.md#slots)

docs/ja/SUMMARY.md

@@ -14,6 +14,7 @@
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [renderToString](api/renderToString.md)
   * [マウンティングオプション](api/options.md)
     - [context](api/options.md#context)
     - [slots](api/options.md#slots)

docs/ja/api/README.md

@@ -2,6 +2,7 @@
 
 * [mount](./mount.md)
 * [shallow](./shallow.md)
+* [renderToString](./renderToString.md)
 * [マウンティングオプション](./options.md)
   - [context](./options.md#context)
   - [slots](./options.md#slots)

docs/ja/api/renderToString.md

@@ -0,0 +1,99 @@
+# `renderToString(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`
+
+- **戻り値:** `{string}`
+
+- **オプション:**
+
+[オプション](./options.md)を参照してください。
+
+- **使い方:**
+
+コンポーネントをHTMLにレンダリングします。
+
+コンポーネントをHTMLにレンダリングするために、`renderToString` は内部で [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) を使用します。
+
+**オプションなし:**
+
+```js
+import { renderToString } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const renderedString = renderToString(Foo)
+    expect(renderedString).toContain('<div></div>')
+  })
+})
+```
+
+**Vueオプションを使用:**
+
+```js
+import { renderToString } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const renderedString = renderToString(Foo, {
+      propsData: {
+        color: 'red'
+      }
+    })
+    expect(renderedString).toContain('red')
+  })
+})
+```
+
+**デフォルトおよび名前付きスロット:**
+
+```js
+import { renderToString } from '@vue/test-utils'
+import Foo from './Foo.vue'
+import Bar from './Bar.vue'
+import FooBar from './FooBar.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const renderedString = renderToString(Foo, {
+      slots: {
+        default: [Bar, FooBar],
+        fooBar: FooBar, // <slot name="FooBar" /> にマッチします。
+        foo: '<div />'
+      }
+    })
+    expect(renderedString).toContain('<div></div>')
+  })
+})
+```
+
+**グローバルプロパティをスタブする:**
+
+```js
+import { renderToString } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const $route = { path: 'http://www.example-path.com' }
+    const renderedString = renderToString(Foo, {
+      mocks: {
+        $route
+      }
+    })
+    expect(renderedString).toContain($route.path)
+  })
+})
+```