Document: phương thức hasStorageAccess()
Baseline
2023
Newly available
Since December 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Phương thức hasStorageAccess() của giao diện Document trả về một Promise phân giải với một giá trị boolean cho biết liệu tài liệu có quyền truy cập vào third-party cookie unpartitioned hay không.
Phương thức này là một phần của Storage Access API.
Note:
Phương thức này là một tên khác của Document.hasUnpartitionedCookieAccess(). Không có kế hoạch hiện tại để loại bỏ phương thức này để ủng hộ Document.hasUnpartitionedCookieAccess().
Cú pháp
hasStorageAccess()
Tham số
Không có.
Giá trị trả về
Một Promise phân giải với một giá trị boolean cho biết liệu tài liệu có quyền truy cập vào third-party cookie — true nếu có, và false nếu không.
Kết quả trả về bởi phương thức này có thể không chính xác trong một vài trường hợp:
- Người dùng có thể có cài đặt trình duyệt đang hoạt động chặn third-party cookie; trong trường hợp này,
truecó thể được trả về mặc dù third-party cookie vẫn không thể truy cập. Để xử lý tình huống này, bạn nên xử lý gracefully bất kỳ lỗi nào dẫn đến giá trị cookie không thể truy xuất; ví dụ: thông báo cho người dùng rằng quyền truy cập vào cài đặt cá nhân hóa của họ bị chặn và mời họ đăng nhập lại để sử dụng. - Trình duyệt có thể không chặn quyền truy cập third-party cookie theo mặc định; trong trường hợp này,
falsecó thể được trả về mặc dù third-party cookie có thể truy cập, và không cần yêu cầu quyền truy cập storage (tức là, quaDocument.requestStorageAccess()). Để giải quyết vấn đề này, bạn có thể truy vấnDocument.cookieđể tìm hiểu xem cookie của bạn có thể truy cập không, và gọiDocument.requestStorageAccess()nếu không.
Note: Nếu promise được phân giải và một sự kiện user gesture đang được xử lý khi hàm ban đầu được gọi, trình xử lý phân giải sẽ chạy như thể một user gesture đang được xử lý, vì vậy nó sẽ có thể gọi các API yêu cầu user activation.
Ngoại lệ
InvalidStateErrorDOMException-
Được ném ra nếu
Documenthiện tại chưa hoạt động.
Ví dụ
document.hasStorageAccess().then((hasAccess) => {
if (hasAccess) {
// quyền truy cập storage đã được cấp.
console.log("truy cập cookie được cấp");
} else {
// quyền truy cập storage chưa được cấp;
// bạn có thể muốn gọi requestStorageAccess().
console.log("truy cập cookie bị từ chối");
}
});
Note: Xem Sử dụng Storage Access API để biết ví dụ đầy đủ hơn.
Đặc tả kỹ thuật
| Specification |
|---|
| The Storage Access API # dom-document-hasstorageaccess |