Navigation: sự kiện currententrychange
Baseline
2026
Newly available
Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sự kiện currententrychange của giao diện Navigation được phát ra khi Navigation.currentEntry đã thay đổi.
Sự kiện này sẽ phát ra cho:
-
Các điều hướng cùng tài liệu (ví dụ:
back()hoặctraverseTo()). -
Các thay thế (tức là, cuộc gọi
navigate()vớihistoryđược đặt thànhreplace). -
Các cuộc gọi khác thay đổi trạng thái của mục (ví dụ:
updateCurrentEntry(), hoặcHistory.replaceState()của History API).
Sự kiện này phát ra sau khi điều hướng được xác nhận, nghĩa là URL hiển thị đã thay đổi và cập nhật NavigationHistoryEntry đã xảy ra. Nó hữu ích để chuyển đổi từ việc sử dụng các tính năng API cũ hơn như sự kiện hashchange hoặc popstate.
Cú pháp
Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt một thuộc tính trình xử lý sự kiện.
addEventListener("currententrychange", (event) => { })
oncurrententrychange = (event) => { }
Loại sự kiện
Một NavigationCurrentEntryChangeEvent. Kế thừa từ Event.
Ví dụ
Báo cáo dữ liệu điều hướng:
navigation.addEventListener("currententrychange", () => {
const data = navigation.currentEntry.getState();
submitAnalyticsData(data.analytics);
});
Thiết lập sự kiện theo từng mục:
navigation.addEventListener("currententrychange", () => {
navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});
Thông số kỹ thuật
| Specification |
|---|
| HTML # event-currententrychange |