docs: update Russian translation (#1215)

Dmitry Sharshakov · kazupon · commit ecfe22860ea0 · 2019-04-26T19:49:44.000+09:00
* docs: update russian translation

* style: format docs pages

* chore(docs): typo
diff --git a/docs/ru/README.md b/docs/ru/README.md
@@ -80,5 +80,6 @@ Vue Test Utils — официальная библиотека модульно
     - [TransitionGroupStub](api/components/TransitionGroupStub.md)
     - [RouterLinkStub](api/components/RouterLinkStub.md)
   - [Селекторы](api/selectors.md)
+  - [createWrapper](api/createWrapper.md)
   - [createLocalVue](api/createLocalVue.md)
   - [Конфигурация](api/config.md)
diff --git a/docs/ru/api/config.md b/docs/ru/api/config.md
@@ -2,7 +2,7 @@
 
 Vue Test Utils включает объект конфигурации для определения опций, используемых Vue Test Utils.
 
-### Конфигурация настроек Vue Test Utils
+### Настройки Vue Test Utils
 
 ### `stubs`
 
diff --git a/docs/ru/api/createWrapper.md b/docs/ru/api/createWrapper.md
@@ -0,0 +1,26 @@
+## createWrapper(node [, options])
+
+- **Аргументы:**
+
+  - `{vm|HTMLElement} node`
+  - `{Object} options`
+    - `{Boolean} sync`
+    - `{Boolean} attachedToDocument`
+
+- **Возвращает:**
+
+  - `{Wrapper}`
+
+- **Использование:**
+
+`createWrapper` создает `Wrapper` для смонтированного экземпляра Vue или HTML-элемента.
+
+```js
+import { createWrapper } from '@vue/test-utils'
+import Foo from './Foo.vue'
+
+const Constructor = Vue.extend(Foo)
+const vm = new Constructor().$mount()
+const wrapper = createWrapper(vm)
+expect(wrapper.vm.foo).toBe(true)
+```
diff --git a/docs/ru/api/options.md b/docs/ru/api/options.md
@@ -2,19 +2,28 @@
 
 Опции для `mount` и `shallowMount`. Объект опций может содержать как настройки монтирования Vue Test Utils, так и другие опции Vue.
 
-- [`context`](#context)
-- [`slots`](#slots)
-- [`scopedSlots`](#scopedslots)
-- [`stubs`](#stubs)
-- [`mocks`](#mocks)
-- [`localVue`](#localvue)
-- [`attachToDocument`](#attachtodocument)
-- [`propsData`](#propsdata)
-- [`attrs`](#attrs)
-- [`listeners`](#listeners)
-- [`parentComponent`](#parentcomponent)
-- [`provide`](#provide)
-- [`sync`](#sync)
+:::tip СОВЕТ
+Кроме опций, описанных ниже, объект `options` может содержать любую опцию, которую можно указать при вызове `new Vue ({ /* опции здесь */ })`.
+Эти опции будут объединены с существующими опциями компонента при монтировании с помощью `mount` / `shallowMount`
+
+[См. другие опции в примере](#other-options)
+:::
+
+- [Опции монтирования](#%D0%BE%D0%BF%D1%86%D0%B8%D0%B8-%D0%BC%D0%BE%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)
+  - [context](#context)
+  - [slots](#slots)
+  - [scopedSlots](#scopedslots)
+  - [stubs](#stubs)
+  - [mocks](#mocks)
+  - [localVue](#localvue)
+  - [attachToDocument](#attachtodocument)
+  - [attrs](#attrs)
+  - [propsData](#propsdata)
+  - [listeners](#listeners)
+  - [parentComponent](#parentcomponent)
+  - [provide](#provide)
+  - [sync](#sync)
+  - [Другие опции](#%D0%B4%D1%80%D1%83%D0%B3%D0%B8%D0%B5-%D0%BE%D0%BF%D1%86%D0%B8%D0%B8)
 
 ## context
 
@@ -108,6 +117,16 @@ shallowMount(Component, {
 
 Или вы можете использовать JSX. Если вы пишете JSX в методе, `this.$createElement` автоматически внедряется babel-plugin-transform-vue-jsx:
 
+```js
+shallowMount(Component, {
+  scopedSlots: {
+    foo(props) {
+      return <div>{props.text}</div>
+    }
+  }
+})
+```
+
 ## stubs
 
 - Тип: `{ [name: string]: Component | boolean } | Array<string>`
@@ -190,6 +209,8 @@ expect(wrapper.vm.$route).toBeInstanceOf(Object)
 
 Компонент будет прикрепляться к DOM при рендеринге, если установлено в `true`.
 
+Если компонент прикреплен к DOM, вы должны вызвать `wrapper.destroy()` в конце вашего теста для того, чтобы удалить отрисованные элементы из документа и удалить экземпляр компонента.
+
 ## attrs
 
 - Тип: `Object`
diff --git a/docs/ru/api/wrapper/attributes.md b/docs/ru/api/wrapper/attributes.md
@@ -1,6 +1,10 @@
 ## attributes()
 
-Возвращает объект атрибута DOM-узла `Wrapper`.
+Возвращает объект атрибутов DOM-узла `Wrapper`. Если аргумент `key` присутствует, метод вернёт значение атрибута, заданного через `key`.
+
+- **Аргументы:**
+
+  - `{string} key` **опционально**
 
 - **Возвращает:** `{[attribute: string]: any}`
 
@@ -12,4 +16,5 @@ import Foo from './Foo.vue'
 
 const wrapper = mount(Foo)
 expect(wrapper.attributes().id).toBe('foo')
+expect(wrapper.attributes('id')).toBe('foo')
 ```
diff --git a/docs/ru/api/wrapper/classes.md b/docs/ru/api/wrapper/classes.md
@@ -2,7 +2,11 @@
 
 Возвращает классы DOM-узла `Wrapper`.
 
-Возвращает массив имён классов.
+Возвращает массив имён классов. Либо `true`/`false` если передано имя класса.
+
+- **Аргументы:**
+
+  - `{string} className` **опционально**
 
 - **Возвращает:** `Array<{string}>`
 
@@ -14,4 +18,5 @@ import Foo from './Foo.vue'
 
 const wrapper = mount(Foo)
 expect(wrapper.classes()).toContain('bar')
+expect(wrapper.classes('bar')).toBe(true)
 ```
diff --git a/docs/ru/api/wrapper/destroy.md b/docs/ru/api/wrapper/destroy.md
@@ -17,3 +17,7 @@ mount({
 }).destroy()
 expect(spy.calledOnce).toBe(true)
 ```
+
+Если опция `attachToDocument` была `true` при монтировании, DOM элементы компонента будут также удалены из документа.
+
+Для функциональных компонентов, `destroy` только удаляет отрисованные элементы DOM из документа.
diff --git a/docs/ru/api/wrapper/html.md b/docs/ru/api/wrapper/html.md
@@ -1,6 +1,6 @@
 ## html()
 
-Возвращает HTML `Wrapper` DOM-узла в виде строки.
+Возвращает HTML-код DOM-узла `Wrapper`а в виде строки.
 
 - **Возвращает:** `{string}`
 
diff --git a/docs/ru/api/wrapper/props.md b/docs/ru/api/wrapper/props.md
@@ -1,9 +1,13 @@
 ## props()
 
-Возвращает объект с входными параметрами `vm` для `Wrapper`.
+Возвращает объект с входными параметрами `vm` для `Wrapper`. Если `key` передан, метод вернёт значения свойства с именем `key`.
 
 **Обратите внимание что Wrapper должен содержать экземпляр Vue.**
 
+- **Принимает:**
+
+  - `{string} key` **опйионально**
+
 - **Возвращает:** `{[prop: string]: any}`
 
 - **Пример:**
@@ -18,4 +22,5 @@ const wrapper = mount(Foo, {
   }
 })
 expect(wrapper.props().bar).toBe('baz')
+expect(wrapper.props('bar')).toBe('baz')
 ```
diff --git a/docs/ru/api/wrapper/setChecked.md b/docs/ru/api/wrapper/setChecked.md
@@ -13,8 +13,8 @@ import { mount } from '@vue/test-utils'
 import Foo from './Foo.vue'
 
 const wrapper = mount(Foo)
-const option = wrapper.find('input[type="radio"]')
-option.setChecked()
+const radioInput = wrapper.find('input[type="radio"]')
+radioInput.setChecked()
 ```
 
 - **Примечание:**
diff --git a/docs/ru/api/wrapper/setValue.md b/docs/ru/api/wrapper/setValue.md
@@ -14,8 +14,8 @@ import Foo from './Foo.vue'
 
 const wrapper = mount(Foo)
 
-const input = wrapper.find('input[type="text"]')
-input.setValue('some value')
+const textInput = wrapper.find('input[type="text"]')
+textInput.setValue('some value')
 
 const select = wrapper.find('select')
 select.setValue('option value')
diff --git a/docs/ru/guides/common-tips.md b/docs/ru/guides/common-tips.md
@@ -58,6 +58,56 @@ expect(wrapper.emitted().foo[1]).toEqual([123])
 
 Вы также можете получить массив событий в порядке их вызова с помощью [`wrapper.emittedByOrder()`](../api/wrapper/emittedByOrder.md).
 
+### События дочерних компонентов
+
+Вы можете создавать пользовательские события в дочерних компонентах получая доступ к экземпляру.
+
+**Тестируемый компонент**
+
+```html
+<template>
+  <div>
+    <child-component @custom="onCustom" />
+    <p v-if="emitted">Emitted!</p>
+  </div>
+</template>
+
+<script>
+  import ChildComponent from './ChildComponent'
+
+  export default {
+    name: 'ParentComponent',
+    components: { ChildComponent },
+    data() {
+      return {
+        emitted: false
+      }
+    },
+    methods: {
+      onCustom() {
+        this.emitted = true
+      }
+    }
+  }
+</script>
+```
+
+**Тест**
+
+```js
+import { shallowMount } from '@vue/test-utils'
+import ParentComponent from '@/components/ParentComponent'
+import ChildComponent from '@/components/ChildComponent'
+
+describe('ParentComponent', () => {
+  it("displays 'Emitted!' when custom event is emitted", () => {
+    const wrapper = shallowMount(ParentComponent)
+    wrapper.find(ChildComponent).vm.$emit('custom')
+    expect(wrapper.html()).toContain('Emitted!')
+  })
+})
+```
+
 ### Манипулирование состоянием компонента
 
 Вы можете напрямую манипулировать состоянием компонента с помощью методов `setData` или `setProps` на обёртке:
diff --git a/docs/ru/guides/dom-events.md b/docs/ru/guides/dom-events.md
@@ -41,14 +41,17 @@ wrapper.trigger('click', { button: 0 })
     <button class="no" @click="callNo">No</button>
   </div>
 </template>
+
 <script>
   export default {
     name: 'YesNoComponent',
+
     props: {
       callMe: {
         type: Function
       }
     },
+
     methods: {
       callYes() {
         this.callMe('yes')
@@ -69,7 +72,7 @@ import { mount } from '@vue/test-utils'
 import sinon from 'sinon'
 
 describe('Click event', () => {
-  it('Нажатие на кнопке yes вызывает наш метод с аргументом "yes"', () => {
+  it('Нажатие на кнопку yes вызывает наш метод с аргументом "yes"', () => {
     const spy = sinon.spy()
     const wrapper = mount(YesNoComponent, {
       propsData: {
@@ -93,6 +96,7 @@ describe('Click event', () => {
 <template>
   <input type="text" @keydown.prevent="onKeydown" v-model="quantity" />
 </template>
+
 <script>
   const KEY_DOWN = 40
   const KEY_UP = 38
@@ -104,6 +108,7 @@ describe('Click event', () => {
         quantity: 0
       }
     },
+
     methods: {
       increment() {
         this.quantity += 1
@@ -129,6 +134,7 @@ describe('Click event', () => {
         }
       }
     },
+
     watch: {
       quantity: function(newValue) {
         this.$emit('input', newValue)
@@ -150,7 +156,7 @@ describe('Тестирование событий клавиш', () => {
     expect(wrapper.vm.quantity).toBe(0)
   })
 
-  it('Клавиша вверх устанавливает quantity равным 1', () => {
+  it('Клавиша вверх увеличивает quantity на 1', () => {
     const wrapper = mount(QuantityComponent)
     wrapper.trigger('keydown.up')
     expect(wrapper.vm.quantity).toBe(1)
diff --git a/docs/ru/guides/testing-single-file-components-with-jest.md b/docs/ru/guides/testing-single-file-components-with-jest.md
@@ -182,18 +182,20 @@ test('renders correctly', () => {
 })
 ```
 
+Мы можем улучшить сохраненный снимок с помощью пользовательского сериализатора:
+
 ```bash
 npm install --save-dev jest-serializer-vue
 ```
 
-Затем добавьте конфигурацию в `package.json`:
+Затем настройте `jest-serializer-vue` в `package.json`:
 
 ```json
 {
   // ...
   "jest": {
     // ...
-    // serializer for snapshots
+    // сериализатор для снимков
     "snapshotSerializers": ["jest-serializer-vue"]
   }
 }
diff --git a/docs/ru/guides/testing-single-file-components-with-mocha-webpack.md b/docs/ru/guides/testing-single-file-components-with-mocha-webpack.md
@@ -1,4 +1,4 @@
-## Тестирование однофайловых компонентов с Mocha + webpack
+## Тестирование однофайловых компонентов с Mocha и webpack
 
 > Пример проекта для этой конфигурации доступен на [GitHub](https://github.com/vuejs/vue-test-utils-mocha-webpack-example).
 
diff --git a/docs/ru/guides/using-with-typescript.md b/docs/ru/guides/using-with-typescript.md
@@ -26,7 +26,7 @@ $ vue create hello-world
 Если вы хотите получить более подробное руководство по настройке Vue с помощью TypeScript, ознакомьтесь с [руководством для начинающих по TypeScript во Vue](https://github.com/Microsoft/TypeScript-Vue-Starter).
 :::
 
-Следующий шаг — добавить Jest к проекту.
+Следующий шаг — добавить Jest в проект.
 
 ### Настройка Jest
 
@@ -90,7 +90,7 @@ npm install --save-dev vue-jest
 $ npm install --save-dev ts-jest
 ```
 
-Затем нам нужно указать Jest обработать тестовые файлы TypeScript с помощью `ts-jest`, добавив запись в `jest.transform` в `package.json`:
+Затем нам нужно указать Jest обрабатывать тестовые файлы TypeScript с помощью `ts-jest`, добавив запись в `jest.transform` в `package.json`:
 
 ```json
 {
@@ -125,7 +125,7 @@ $ npm install --save-dev ts-jest
 }
 ```
 
-Jest рекомендует создать каталог `__tests__` рядом с тестируемым кодом, но не стесняйтесь структурировать ваши тесты по своему усмотрению. Просто остерегайтесь того, что Jest создаст каталог `__snapshots__` рядом с тестовыми файлами, которые выполняют тестирование моментальными снимками.
+Jest рекомендует создать каталог `__tests__` рядом с тестируемым кодом, но не стесняйтесь структурировать ваши тесты по своему усмотрению. Просто помните, что Jest создаст каталог `__snapshots__` рядом с тестовыми файлами, которые выполняют тестирование моментальными снимками.
 
 ### Написание модульного теста
 
@@ -139,7 +139,7 @@ import { shallowMount } from '@vue/test-utils'
 import HelloWorld from '../HelloWorld.vue'
 
 describe('HelloWorld.vue', () => {
-  test('renders props.msg when passed', () => {
+  test('отрисовывает props.msg, если они переданы', () => {
     const msg = 'new message'
     const wrapper = shallowMount(HelloWorld, {
       propsData: { msg }
diff --git a/docs/ru/guides/using-with-vuex.md b/docs/ru/guides/using-with-vuex.md
