NavigationPrecommitController: phương thức redirect()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức redirect() của giao diện NavigationPrecommitController chuyển hướng trình duyệt đến một URL được chỉ định và xác định hành vi lịch sử cùng bất kỳ thông tin trạng thái nào mong muốn.

Cú pháp

redirect(url, options)

Tham số

url

URL để chuyển hướng đến.

options Optional

Một đối tượng tùy chọn, các thuộc tính của nó có thể bao gồm:

state Optional

Chứa bất kỳ thông tin trạng thái nào bạn muốn truyền cùng với điều hướng; ví dụ: cho mục đích ghi log hoặc theo dõi. Điều này có thể được đại diện bởi bất kỳ loại giá trị nào. Trạng thái cho điều hướng có thể được lấy sau đó qua phương thức NavigationHistoryEntry.getState() của mục lịch sử kết quả.

history Optional

Một giá trị liệt kê chỉ định cách chuyển hướng này nên được thêm vào lịch sử điều hướng. Nó có thể nhận một trong các giá trị sau:

auto

Giá trị mặc định, cho phép trình duyệt quyết định cách xử lý:

Nếu điều hướng gốc xảy ra do lệnh gọi Navigation.navigate(), giá trị sẽ là bất cứ điều gì được chỉ định trong tùy chọn history của lệnh gọi navigate().
Nếu không, giá trị được sử dụng thường là push, nhưng sẽ trở thành replace nếu chuyển hướng trỏ đến cùng URL với URL trước điều hướng.

push

Thêm một NavigationHistoryEntry mới vào lịch sử điều hướng và xóa bất kỳ điều hướng về phía trước khả dụng nào (nghĩa là nếu người dùng trước đó đã điều hướng đến các vị trí khác, sau đó sử dụng nút quay lại để trở về qua lịch sử trước khi khởi tạo điều hướng gây ra chuyển hướng).

replace

Thay thế Navigation.currentEntry bằng NavigationHistoryEntry mới kết quả.

Note: Phương thức redirect() có thể chuyển đổi hành vi lịch sử giữa auto, push và replace, nhưng nó không thể chuyển đổi điều hướng traverse thành điều hướng push/replace và ngược lại.