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

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Phương thức go() của giao diện History tải một trang cụ thể từ lịch sử phiên. Bạn có thể dùng nó để di chuyển tiến hoặc lùi trong lịch sử tùy theo giá trị của tham số.

Phương thức này là bất đồng bộ. Hãy thêm trình nghe cho sự kiện popstate để xác định khi nào quá trình điều hướng đã hoàn tất.

Cú pháp

js
go()
go(delta)

Tham số

delta Optional

Vị trí trong lịch sử mà bạn muốn di chuyển tới, tính tương đối so với trang hiện tại. Giá trị âm sẽ đi lùi, giá trị dương sẽ đi tới. Ví dụ, history.go(2) sẽ tiến hai trang và history.go(-2) sẽ lùi hai trang. Nếu không truyền giá trị hoặc nếu delta bằng 0, kết quả sẽ giống như gọi location.reload().

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. Trình duyệt cũng giới hạn tần suất điều hướng và có thể ném lỗi này, tạo cảnh báo hoặc bỏ qua lời gọi nếu nó được gọi quá thường xuyên.

Ví dụ

Để lùi lại một trang (tương đương với việc gọi back()):

js
history.go(-1);

Để chuyển tới một trang, giống như gọi forward():

js
history.go(1);

Để tiến lên hai trang:

js
history.go(2);

Để lùi lại hai trang:

js
history.go(-2);

Cuối cùng, một trong hai câu lệnh sau sẽ tải lại trang hiện tại:

js
history.go();
history.go(0);

Thông số kỹ thuật

Thông số kỹ thuật
HTML
# dom-history-go-dev

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

Xem thêm