NavigationCurrentEntryChangeEvent

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.

Giao diện NavigationCurrentEntryChangeEvent của Navigation API là đối tượng sự kiện cho sự kiện currententrychange, kích hoạt khi Navigation.currentEntry đã thay đổi.

Sự kiện này sẽ kích hoạt đối với các điều hướng cùng tài liệu (ví dụ: back() hoặc traverseTo()), thay thế (tức là lệnh gọi navigate() với history được đặt thành replace), hoặc các lệnh gọi khác thay đổi trạng thái của mục (ví dụ: updateCurrentEntry(), hoặc History.replaceState() của History API).

Sự kiện này kích hoạt sau khi điều hướng được xác nhận, nghĩa là URL hiển thị đã thay đổi và bản cập nhật NavigationHistoryEntry đã xảy ra. Nó hữu ích để di chuyển từ việc sử dụng các tính năng API cũ hơn như sự kiện hashchange hoặc popstate.

Event NavigationCurrentEntryChangeEvent

Hàm khởi tạo

Tạo một thực thể đối tượng NavigationCurrentEntryChangeEvent mới.

Thuộc tính phiên bản

Kế thừa các thuộc tính từ lớp cha, Event.

from Read only

Trả về NavigationHistoryEntry đã được điều hướng từ đó.

Trả về loại điều hướng đã dẫn đến thay đổi.

Ví dụ

Báo cáo dữ liệu điều hướng:

js
navigation.addEventListener("currententrychange", () => {
  const data = navigation.currentEntry.getState();
  submitAnalyticsData(data.analytics);
});

Thiết lập sự kiện theo từng mục:

js
navigation.addEventListener("currententrychange", () => {
  navigation.currentEntry.addEventListener("dispose", genericDisposeHandler);
});

Thông số kỹ thuật

Specification
HTML
# the-navigationcurrententrychangeevent-interface

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

Xem thêm