Navigation: phương thức forward()

Cú pháp

forward(options)

Tham số

options Optional

Một đối tượng tùy chọn chứa các thuộc tính sau:

info Optional

Thông tin do nhà phát triển định nghĩa để truyền cùng với sự kiện navigate, có sẵn trong NavigateEvent.info. Đây có thể là bất kỳ kiểu dữ liệu nào. Ví dụ, bạn có thể muốn hiển thị nội dung được điều hướng đến với một animation khác nhau tùy thuộc vào cách nó được điều hướng tới (vuốt trái, vuốt phải, hoặc về trang chủ). Một chuỗi chỉ ra animation nào cần dùng có thể được truyền vào dưới dạng info.

Giá trị trả về

Một đối tượng với các thuộc tính sau:

committed

Một Promise sẽ được thực hiện khi URL hiển thị đã thay đổi và một NavigationHistoryEntry mới đã được tạo.

finished

Một Promise sẽ được thực hiện khi tất cả các promise được trả về bởi trình xử lý NavigateEvent.intercept() đều được thực hiện. Điều này tương đương với promise NavigationTransition.finished được thực hiện, khi sự kiện navigatesuccess kích hoạt.

Một trong hai promise này sẽ bị từ chối nếu việc điều hướng thất bại vì lý do nào đó.

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu giá trị NavigationHistoryEntry.index của Navigation.currentEntry là -1 hoặc navigation.entries().length - 1, tức là Document hiện tại chưa được kích hoạt, hoặc mục lịch sử hiện tại là mục cuối cùng trong lịch sử, nghĩa là không thể điều hướng tiến, hoặc nếu Document hiện tại đang bị gỡ bỏ.

Ví dụ

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");
  }
}

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• Modern client-side routing: the Navigation API
• Navigation API explainer