History: phương thức replaceState()

Cú pháp

replaceState(state, unused)
replaceState(state, unused, url)

Tham số

state

Một đối tượng được liên kết với mục lịch sử được truyền vào phương thức replaceState(). Đối tượng trạng thái có thể là null.

unused

Tham số này tồn tại vì lý do lịch sử, và không thể bị bỏ qua; truyền chuỗi rỗng là cách làm truyền thống và an toàn trước các thay đổi trong tương lai của phương thức.

url Optional

URL của mục lịch sử. URL mới phải có cùng origin với URL hiện tại; nếu không, phương thức replaceState() sẽ ném ra ngoại lệ.

Giá trị trả về

Không có (undefined).

Ngoại lệ

SecurityError DOMException

Được ném ra nếu tài liệu liên kết chưa hoàn toàn hoạt động, hoặc nếu tham số url được cung cấp không phải là URL hợp lệ, hoặc nếu phương thức được gọi quá thường xuyên.

DataCloneError DOMException

Được ném ra nếu tham số state được cung cấp không thể tuần tự hóa.

Ví dụ

Giả sử https://www.mozilla.org/foo.html thực thi JavaScript sau:

const stateObj = { foo: "bar" };
history.pushState(stateObj, "", "bar.html");

Trên trang kế tiếp, bạn có thể dùng history.state để truy cập stateObj vừa được thêm vào.

Giải thích của hai dòng lệnh trên có thể được tìm thấy trong bài viết Làm việc với History API. Sau đó giả sử https://www.mozilla.org/bar.html thực thi JavaScript sau:

history.replaceState(stateObj, "", "bar2.html");

Điều này sẽ khiến thanh URL hiển thị https://www.mozilla.org/bar2.html, nhưng sẽ không khiến trình duyệt tải bar2.html hay thậm chí kiểm tra xem bar2.html có tồn tại hay không.

Giờ giả sử người dùng điều hướng đến https://www.microsoft.com, sau đó nhấn nút Back. Lúc này, thanh URL sẽ hiển thị https://www.mozilla.org/bar2.html. Nếu người dùng nhấn Back thêm một lần nữa, thanh URL sẽ hiển thị https://www.mozilla.org/foo.html, hoàn toàn bỏ qua bar.html.

Thông số kỹ thuật

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