Navigation: phương thức reload()
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.
Phương thức reload() của giao diện Navigation tải lại URL hiện tại, cập nhật bất kỳ trạng thái nào được cung cấp trong danh sách mục lịch sử.
Lưu ý rằng reload() không kích hoạt sự kiện popstate, vì sự kiện này chỉ được phát ra cho các điều hướng mềm gây ra "traversal" của các mục lịch sử.
Cú pháp
reload()
reload(options)
Tham số
optionsOptional-
Một đối tượng tùy chọn chứa các thuộc tính sau:
stateOptional-
Thông tin do nhà phát triển định nghĩa để lưu trong
NavigationHistoryEntryliên quan sau khi điều hướng hoàn tất, có thể truy xuất quagetState(). Đây có thể là bất kỳ kiểu dữ liệu nào. Ví dụ, bạn có thể muốn lưu số lượt truy cập trang cho mục đích phân tích, hoặc lưu chi tiết trạng thái UI để view có thể hiển thị chính xác như người dùng đã để lần cuối. Mọi dữ liệu lưu trongstatephải là có thể sao chép có cấu trúc. infoOptional-
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 trongNavigateEvent.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ạnginfo.
Giá trị trả về
Một đối tượng với các thuộc tính sau:
committed-
Một
Promisesẽ được thực hiện khi URL hiển thị đã thay đổi và mộtNavigationHistoryEntrymới đã được tạo. finished-
Một
Promisesẽ được thực hiện khi tất cả các promise được trả về bởi trình xử lýintercept()đều được thực hiện. Điều này tương đương với promiseNavigationTransition.finishedđược thực hiện, khi sự kiệnnavigatesuccesskí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ệ
DataCloneErrorDOMException-
Được ném ra nếu tham số
statechứa các giá trị không thể sao chép có cấu trúc.
Ví dụ
Sử dụng info và state
async function handleReload() {
await navigation.reload({
info: { animation: "fade-in" },
state: { infoPaneOpen: true },
}).finished;
// Update application state
// …
}
Tải lại trang và thêm một mục trạng thái mới:
async function handleReload() {
await navigation.reload({
state: { ...navigation.currentEntry.getState(), newState: 3 },
}).finished;
// Update application state
// …
}
Thông số kỹ thuật
| Specification |
|---|
| HTML # dom-navigation-reload-dev |