docs: [RU] Translation update (#3285)

* docs: [RU] Translation update * README.md обновление * navigation.md fix * consistent code blocks * dynamic-matching.md add new section * dynamic-matching.md fix * navigation-guards.md fix title * data-fetching.md fix * README.md fix * (docs) [RU] Translation update * fix typo * navigation-guards.md update * redirect-and-alias.md update * change '$route' to $route * date-fetching.md formatting * histort-mode.md update * navigation-guards.md update * navigation-guards.md update * navigation-guards.md fix example * api.md added aria-current-value * installation.md update * history-mode.md update * docs: (ru) navigation-failures.md added Co-authored-by: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com>
vuejs · Aug 8, 2020 · 5c4221a · 5c4221a
1 parent 0b073d4
commit 5c4221a
Show file tree

Hide file tree

Showing 2 changed files with 66 additions and 1 deletion.
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
@@ -270,7 +270,8 @@ module.exports = ctx => ({
               '/ru/guide/advanced/transitions.md',
               '/ru/guide/advanced/data-fetching.md',
               '/ru/guide/advanced/scroll-behavior.md',
-              '/ru/guide/advanced/lazy-loading.md'
+              '/ru/guide/advanced/lazy-loading.md',
+              '/ru/guide/advanced/navigation-failures.md'
             ]
           }
         ]

diff --git a/docs/ru/guide/advanced/navigation-failures.md b/docs/ru/guide/advanced/navigation-failures.md
@@ -0,0 +1,64 @@
+# Сбои при навигации
+
+> Добавлено в версии 3.4.0
+
+При использовании `router-link` Vue Router вызывает `router.push` для запуска навигации. В большинстве случаев ожидаемое поведение ссылок заключается в переходе на новую страницу, но есть несколько ситуаций при которых пользователь остаётся на той же странице:
+
+- Пользователь уже находится на странице, на которую пытается перейти
+- [Навигационный хук](./navigation-guards.md) прерывает навигацию вызовом `next(false)`
+- [Навигационный хук](./navigation-guards.md) выбрасывает ошибку или вызывает `next(new Error())`
+
+При использовании компонента `router-link` **ни один из этих случаев не будет логироваться как ошибка**. Однако при использовании `router.push` или `router.replace` можно столкнуться с сообщением _"Uncaught (in promise) Error"_ после которого в консоли последует более конкретное сообщение. Давайте разберемся как отличать _сбои навигации_.
+
+::: tip История вопроса
+В версии 3.2.0, _навигационные сбои_ доступны через два необязательных коллбэка `router.push`: `onComplete` и `onAbort`. Начиная с версии 3.1.0, `router.push` и `router.replace` возвращают _Promise_ если не указаны коллбэки `onComplete`/`onAbort`. Этот _Promise_ разрешается вместо вызова `onComplete` и отклоняется вместо вызова `onAbort`.
+ :::
+
+## Обнаружение сбоев навигации
+
+_Сбой навигации_ будет экземпляром `Error` с парой дополнительных свойств. Проверить произошла ли ошибка в маршрутизаторе можно с помощью функции `isNavigationFailure`:
+
+```js
+import { NavigationFailureType, isNavigationFailure } from 'vue-router'
+
+// попытка перехода к странице администрирования
+router
+  .push('/admin')
+  .catch(failure => {
+    if (isNavigationFailure(failure, NavigationFailureType.redirected)) {
+      // отображение уведомления пользователю
+      showToast('Необходимо авторизоваться для доступа к панели администрирования')
+    }
+  })
+```
+
+::: tip СОВЕТ
+Если опустить второй параметр в `isNavigationFailure(failure)`, то будет проверяться только, является ли ошибка _сбоем навигации_.
+:::
+
+## Тип `NavigationFailureType`
+
+Тип `NavigationFailureType` поможет разработчикам определять тип _навигационного сбоя_. Существует 4 различных типа:
+
+- `redirected`: внутри навигационного хука был вызван `next(newLocation)` для перенаправления в другое место.
+- `aborted`: внутри навигационного хука был вызван `next(false)` для отмены навигации.
+- `cancelled`: произошла полностью новая навигация до того, как текущая могла закончиться. Например, во время ожидания внутри навигационного хука был вызван `router.push`.
+- `duplicated`: навигация была предотвращена, потому что уже находимся в месте назначения.
+
+## Свойства _ошибок навигации_
+
+Все сбои навигации предоставляют доступ к свойствам `to` и `from`, чтобы отобразить текущее местоположение, а также местоположение места назначения для навигации, в которой произошёл сбой:
+
+```js
+// попытка получения доступа к странице администрирования
+router
+  .push('/admin')
+  .catch(failure => {
+    if (isNavigationFailure(failure, NavigationFailureType.redirected)) {
+      console.log(failure.to.path) // '/admin'
+      console.log(failure.from.path) // '/'
+    }
+  })
+```
+
+Во всех случаях значения `to` и `from` будут объектами нормализованных маршрутов.