Location: phương thức assign()
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 assign() của giao diện Location khiến cửa sổ tải và hiển thị tài liệu tại URL được chỉ định. Sau khi điều hướng xảy ra, người dùng có thể quay lại trang đã gọi Location.assign() bằng cách nhấn nút "back".
Cú pháp
assign(url)
Tham số
url-
Một chuỗi hoặc bất kỳ đối tượng nào khác có stringifier, chẳng hạn một đối tượng
URL, chứa URL của trang mà bạn muốn điều hướng tới; ví dụ một URL tuyệt đối nhưhttps://mdn.go-mizu.dev/vi/docs/Web/API/Location/reload, hoặc một URL tương đối - chẳng hạn/Web(chỉ là một path, để điều hướng tới tài liệu khác cùng origin) hoặc#specifications(chỉ là fragment string, để điều hướng tới một phần của cùng trang), v.v.
Ngoại lệ
SecurityErrorDOMException-
Được ném ra nếu origin của script gọi phương thức không phải là same origin với trang được mô tả ban đầu bởi đối tượng
Location, thường là khi script được lưu trữ trên một domain khác. 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. SyntaxErrorDOMException-
Được ném ra nếu tham số
urlđược cung cấp không phải là URL hợp lệ.
Giá trị trả về
Không có (undefined).
Ví dụ
// Điều hướng đến bài viết Location.reload
window.location.assign(
"https://mdn.go-mizu.dev/vi/docs/Web/API/Location/reload",
);
// Sau đó điều hướng đến phần Specifications của nó
window.location.assign("#specifications");
// Cuối cùng điều hướng đến https://mdn.go-mizu.dev/vi/docs/Web
window.location.assign("/Web");
Thông số kỹ thuật
| Specification |
|---|
| HTML # dom-location-assign-dev |
Tương thích trình duyệt
Xem thêm
- Giao diện
Locationmà nó thuộc về. - Các phương thức tương tự:
Location.replace()vàLocation.reload().