docs(createlocalvue): document the errorHandler option in createLocalVue

vuejs · lmiller1990 · Sep 10, 2020 · Aug 26, 2020 · Aug 26, 2020 · Aug 27, 2020
commit ba9f6777e4159f7bc5e7f35502371863fe3621fc
diff --git a/docs/api/createLocalVue.md b/docs/api/createLocalVue.md
@@ -1,5 +1,10 @@
 ## createLocalVue()
 
+- **Arguments:**
+
+  - `{Object} options`
+    - `{Function} errorHandler`
+
 - **Returns:**
 
   - `{Component}`
@@ -8,8 +13,12 @@
 
 `createLocalVue` returns a Vue class for you to add components, mixins and install plugins without polluting the global Vue class.
 
+The `errorHandler` option can be used to handle uncaught errors during component render function and watchers.
+
 Use it with `options.localVue`:
 
+**Without options:**
+
 ```js
 import { createLocalVue, shallowMount } from '@vue/test-utils'
 import MyPlugin from 'my-plugin'
@@ -27,4 +36,24 @@ const freshWrapper = shallowMount(Foo)
 expect(freshWrapper.vm.foo).toBe(false)
 ```
 
+**With the [`errorHandler`](https://vuejs.org/v2/api/#errorHandler) option:**
+
+```js
+import { createLocalVue, shallowMount } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+const errorHandler = (err, vm, info) => {
+  expect(err).toBeInstanceOf(Error)
+}
+
+const localVue = createLocalVue({
+  errorHandler
+})
+
+// Foo throws an error inside a lifecycle hook
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
 - **See also:** [Common Tips](../guides/common-tips.md#applying-global-plugins-and-mixins)
diff --git a/docs/ja/api/createLocalVue.md b/docs/ja/api/createLocalVue.md
@@ -1,5 +1,10 @@
 ## createLocalVue()
 
+- **引数:**
+
+  - `{Object} options`
+    - `{Function} errorHandler`
+
 - **戻り値:**
 
   - `{Component}`
@@ -8,8 +13,12 @@
 
 `createLocalVue` は、グローバル Vue クラスを汚染することなくコンポーネント、ミックスイン、プラグインを追加するための Vue クラスを返します。
 
+[errorHandler](https://jp.vuejs.org/v2/api/index.html#errorHandler)オプションを使用すると、コンポーネントのレンダー機能とウォッチャー中にキャッチされなかったエラーを処理できます。
+
 `options.localVue` と一緒に使用してください。
 
+**オプションなし:**
+
 ```js
 import { createLocalVue, shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
@@ -25,4 +34,24 @@ const freshWrapper = shallowMount(Foo)
 expect(freshWrapper.vm.foo).toBe(false)
 ```
 
+**[errorHandler](https://jp.vuejs.org/v2/api/index.html#errorHandler)オプションを使用:**
+
+```js
+import { createLocalVue, shallowMount } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+const errorHandler = (err, vm, info) => {
+  expect(err).toBeInstanceOf(Error)
+}
+
+const localVue = createLocalVue({
+  errorHandler
+})
+
+// Fooがライフサイクルフック内でエラーをスローする
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
 - **参照:** [一般的なヒント](../guides/common-tips.md#グローバルプラグインとミックスインの適用)
diff --git a/docs/ru/api/createLocalVue.md b/docs/ru/api/createLocalVue.md
@@ -1,5 +1,10 @@
 ## createLocalVue()
 
+- **Аргументы:**
+
+  - `{Object} options`
+    - `{Function} errorHandler`
+
 - **Возвращает:**
 
   - `{Component}`
@@ -8,8 +13,12 @@
 
 `createLocalVue` возвращает класс Vue, чтобы вы могли добавлять компоненты, примеси и устанавливать плагины без загрязнения глобального класса Vue.
 
+Опция [errorHandler](https://ru.vuejs.org/v2/api/index.html#errorHandler) может использоваться для обработки неперехваченных ошибок во время функции визуализации компонента и наблюдателей.
+
 Используйте вместе с `options.localVue`:
 
+**Без опций:**
+
 ```js
 import { createLocalVue, shallowMount } from '@vue/test-utils'
 import Foo from './Foo.vue'
@@ -25,4 +34,24 @@ const freshWrapper = shallowMount(Foo)
 expect(freshWrapper.vm.foo).toBe(false)
 ```
 
+**С опцией [errorHandler](https://ru.vuejs.org/v2/api/index.html#errorHandler):**
+
+```js
+import { createLocalVue, shallowMount } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+const errorHandler = (err, vm, info) => {
+  expect(err).toBeInstanceOf(Error)
+}
+
+const localVue = createLocalVue({
+  errorHandler
+})
+
+// Foo выдает ошибку внутри ловушки жизненного цикла
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
 - **См. также:** [Общие советы](../guides/common-tips.md#добавnение-гnобаnьных-пnагинов-и-примесей)
diff --git a/docs/zh/api/createLocalVue.md b/docs/zh/api/createLocalVue.md
@@ -1,5 +1,10 @@
 ## createLocalVue()
 
+- **参数：**
+
+  - `{Object} options`
+    - `{Function} errorHandler`
+
 - **返回值：**
 
   - `{Component}`
@@ -8,8 +13,12 @@
 
 `createLocalVue` 返回一个 Vue 的类供你添加组件、混入和安装插件而不会污染全局的 Vue 类。
 
+在组件渲染功能和观察者期间，[`errorHandler`](https://cn.vuejs.org/v2/api/index.html#errorHandler)选项可用于处理未捕获的错误。
+
 可通过 `options.localVue` 来使用：
 
+**Without options:**
+
 ```js
 import { createLocalVue, shallowMount } from '@vue/test-utils'
 import MyPlugin from 'my-plugin'
@@ -27,4 +36,24 @@ const freshWrapper = shallowMount(Foo)
 expect(freshWrapper.vm.foo).toBe(false)
 ```
 
+**使用[`errorHandler`](https://cn.vuejs.org/v2/api/index.html#errorHandler)选项:**
+
+```js
+import { createLocalVue, shallowMount } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+const errorHandler = (err, vm, info) => {
+  expect(err).toBeInstanceOf(Error)
+}
+
+const localVue = createLocalVue({
+  errorHandler
+})
+
+// Foo在生命周期挂钩中引发错误
+const wrapper = shallowMount(Foo, {
+  localVue
+})
+```
+
 - **延伸阅读：**[常用技巧](../guides/common-tips.md#applying-global-plugins-and-mixins)