Метод Navigation: forward()

Ограниченная доступность

Эта функция не относится к Baseline, поскольку она не работает в некоторых из наиболее широко используемых браузеров.

Экспериментально: Это экспериментальная технология
Перед использованием в продуктовой среде внимательно ознакомьтесь с таблицей совместимости браузеров.

Метод forward() интерфейса Navigation осуществляет навигацию вперёд на одну запись в истории навигации.

Синтаксис

forward(options)

Параметры

options Необязательно

Объект параметров, содержащий следующие свойства:

info Необязательно: Информация, определённая разработчиком, которая передаётся событию navigate, доступная в NavigateEvent.info. Это может быть любой тип данных. Например, можно отобразить недавно перенаправленное содержимое с другой анимацией в зависимости от способа перехода (свайп влево, свайп вправо или переход на главную). В качестве info можно передать строку, указывающую, какую анимацию использовать.

Возвращаемое значение

Объект со следующими свойствами:

committed: Promise, который выполнится, когда видимый URL изменится и будет создана новая запись NavigationHistoryEntry.
finished: Promise, который выполнится, когда все обещания, возвращённые обработчиком NavigateEvent.intercept(), будут выполнены. Это эквивалентно выполнению обещания NavigationTransition.finished, когда произойдёт событие navigatesuccess.

Любое из этих обещаний отклонится, если навигация по какой-либо причине не удалась.

Исключения

InvalidStateError DOMException: Выбрасывается, если значение Navigation.currentEntry's NavigationHistoryEntry.index равно -1 или navigation.entries().length - 1, т.е. текущий Document ещё не активен, или текущая запись истории является последней в истории, что означает, что навигация вперёд невозможна, или если текущий Document загружается.

Примеры

async function backHandler() {
  if (navigation.canGoBack) {
    await navigation.back().finished;
    // Handle any required clean-up after
    // navigation has finished
  } else {
    displayBanner("You are on the first page");
  }
}

async function forwardHandler() {
  if (navigation.canGoForward) {
    await navigation.forward().finished;
    // Handle any required clean-up after
    // navigation has finished
  } else {
    displayBanner("You are on the last page");
  }
}

Спецификации

Спецификация
HTML # dom-navigation-forward-dev

Совместимость браузеров

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`forward`	102	102	Нет	88	Нет	102	Нет	70	Нет	19.0	102

См. также

Современный клиентский маршрутизатор: API навигации
Описание API навигации
Демонстрация API навигации Domenic Denicola

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigation/forward