Документация API / Router

Интерфейс: Router

Экземпляр маршрутизатора.

Свойства

currentRoute

• Readonly currentRoute: Ref<RouteLocationNormalizedLoaded>

Текущий RouteLocationNormalized

---

listening

• listening: boolean

Позволяет отключить прослушивание событий истории. Это низкоуровневый api для микрофронтендов.

---

options

• Readonly options: RouterOptions

Начальный объект опций, переданный для создания маршрутизатора

Методы

addRoute

▸ addRoute(parentName, route): () => void

Добавление новой записи маршрута в качестве дочерней записи существующего маршрута.

Параметры

Название	Тип	Описание
parentName	RouteRecordName	Название родительской записи маршрута, в которую будет добавлен новый
route	RouteRecordRaw	Запьсь маршрута для добавления

Возвращает

fn

▸ (): void

Возвращает

void

▸ addRoute(route): () => void

Добавление в маршрутизатор новой записи маршрута.

Параметры

Название	Тип	Описание
route	RouteRecordRaw	Запись маршрута, которую необходимо добавить

Возвращает

fn

▸ (): void

Возвращает

void

---

afterEach

▸ afterEach(guard): () => void

Добавление навигационного хука, который выполняется после каждого перехода навигации. Возвращает функцию, которая удаляет зарегистрированный хук.

Параметры

Название	Тип	Описание
guard	NavigationHookAfter	навигационный хук, который необходимо добавить

Возвращает

fn

функция, удаляющая зарегестрированный навигационный хук

▸ (): void

Возвращает

void

Пример

router.afterEach((to, from, failure) => {
  if (isNavigationFailure(failure)) {
    console.log('failed navigation', failure)
  }
})

---

back

▸ back(): void

Переход по истории назад, если это возможно, при помощи вызова history.back(). Эквивалентно router.go(-1).

Возвращает

void

---

beforeEach

▸ beforeEach(guard): () => void

Добавление навигационного хука, который выполняется перед каждым переходом навигации. Возвращает функцию, которая удаляет зарегистрированный хук.

Параметры

Название	Тип	Описание
guard	NavigationGuardWithThis<undefined>	навигационный хук, который необходимо добавить

Возвращает

fn

▸ (): void

Возвращает

void

---

beforeResolve

▸ beforeResolve(guard): () => void

Добавление навигационного хука, который выполняется перед тем, как навигация будет разрешена. В этом состоянии все компоненты уже загружены, а другие хуки успешно отработали. Возвращает функцию, которая удаляет зарегистрированный хук.

Параметры

Название	Тип	Описание
guard	NavigationGuardWithThis<undefined>	авигационный хук, который необходимо добавить

Возвращает

fn

функция, удаляющая зарегестрированный навигационный хук

▸ (): void

Возвращает

Пример

router.beforeResolve(to => {
  if (to.meta.requiresAuth && !isAuthenticated) return false
})

---

forward

▸ forward(): void

Переход по истории вперед, если это возможно, при помощи вызова history.forward(). Эквивалентно router.go(1).

Возвращает

void

---

getRoutes

▸ getRoutes(): RouteRecordNormalized[]

Получение полного списка всех записей маршрутов.

Возвращает

RouteRecordNormalized[]

---

go

▸ go(delta): void

Позволяет перемещаться вперед или назад по истории. Вызывает history.go().

Параметры

Название	Тип	Описание
delta	number	Позиция в истории, на которую вы хотите переместиться, относительно текущей страницы

Возвращает

void

---

hasRoute

▸ hasRoute(name): boolean

Проверка на существования записи маршрута с заданным названием

Параметры

Название	Тип	Описание
name	RouteRecordName	Название записи маршрута для проверки

Возвращает

boolean

---

isReady

▸ isReady(): Promise<void>

Возвращает Promise, который будет разрешен, когда маршрутизатор завершит начальную навигацию. Это означает, что он разрешит все начальные асинхронные хуки и асинхронные компоненты, связанные с начальным маршрутом. Если начальная навигация уже произошла, promise разрешается немедленно.

Это полезно в рендеринге на стороне сервера для обеспечения согласованного вывода как на сервере, так и на клиенте. Обратите внимание, что на сервере вам необходимо вручную выполнять начальную навигацию, в то время как на клиентской стороне маршрутизатор автоматически получает ее из URL.

Возвращает

Promise<void>

---

onError

▸ onError(handler): () => void

Добавляет обработчик ошибок, который вызывается каждый раз, когда происходит необработанная ошибка во время навигации. Включает в себя ошибки, выброшенные синхронно и асинхронно, ошибки, возвращенные или переданные в next в любом навигационном хуке, а также ошибки, возникшие при попытке разрешить асинхронный компонент, необходимый для отображения маршрута.

Параметры

Названием	Тип	Описание
handler	_ErrorListener	обработчик ошибок, который необходимо добавить

Возвращает

fn

▸ (): void

Возвращает

void

---

push

▸ push(to): Promise<undefined | void | NavigationFailure>

Программный переход к новому URL-адресу путем добавления записи в стек истории стек.

Параметры

Название	Тип	Описание
to	RouteLocationRaw	Описание маршрута для перехода

Возвращает

Promise<undefined | void | NavigationFailure>

---

removeRoute

▸ removeRoute(name): void

Удаление существующей записи маршрута по её названию.

Параметры

Название	Тип	Описание
name	RouteRecordName	Имя маршрута, который необходимо удалить

Возвращает

void

---

replace

▸ replace(to): Promise<undefined | void | NavigationFailure>

Программный переход к новому URL-адресу путем замены текущей записи в стеке истории.

Параметры

Название	Тип	Описание
to	RouteLocationRaw	Описание маршрута для перехода

Возвращает

Promise<undefined | void | NavigationFailure>

---

resolve

▸ resolve(to, currentLocation?): RouteLocation & { href: string }

Возвращает нормализованную версию описания маршрута. Также включает свойство href, которое включает любое существующее base. По умолчанию в качестве currentLocation используется router.currentRoute, и переопределять его следует только в продвинутых вариантах использования.

Параметры

Название	Тип	Описание
to	RouteLocationRaw	Необработанное описание маршрута для разрешения
currentLocation?	RouteLocationNormalizedLoaded	Необязательное текущее описание маршрута для относительного разрешения

Возвращает

RouteLocation & { href: string }