Document: requestStorageAccessFor() method

Cú pháp

requestStorageAccessFor(requestedOrigin)

Tham số

requestedOrigin

Một chuỗi đại diện cho URL của nguồn gốc bạn đang yêu cầu quyền truy cập cookie bên thứ ba.

Giá trị trả về

Một Promise thỏa mãn với undefined nếu quyền truy cập cookie bên thứ ba được cấp và từ chối nếu quyền truy cập bị từ chối.

Các yêu cầu requestStorageAccessFor() tự động bị từ chối trừ khi nội dung cấp cao nhất hiện đang xử lý một cử chỉ người dùng như nhấn hoặc nhấp (transient activation), hoặc trừ khi quyền đã được cấp trước đó. Nếu quyền chưa được cấp trước đó, chúng phải chạy bên trong một trình xử lý sự kiện dựa trên cử chỉ người dùng. Hành vi cử chỉ người dùng phụ thuộc vào trạng thái của promise:

• Nếu promise được giải quyết (tức là quyền được cấp), thì cử chỉ người dùng chưa bị tiêu thụ, do đó tập lệnh có thể gọi các API yêu cầu cử chỉ người dùng sau đó.
• Nếu promise bị từ chối (tức là quyền không được cấp), thì cử chỉ người dùng đã bị tiêu thụ, do đó tập lệnh không thể làm bất cứ điều gì yêu cầu một cử chỉ. Điều này ngăn các tập lệnh gọi lại requestStorageAccessFor() nếu quyền bị từ chối.

Ngoại lệ

InvalidStateError DOMException

Được ném nếu Document hiện tại chưa hoạt động.

NotAllowedError DOMException

Được ném nếu:

• Cửa sổ của tài liệu không phải là ngữ cảnh bảo mật.
• Tài liệu không phải là tài liệu cấp cao nhất.
• Tài liệu có nguồn gốc null.
• requestedOrigin được cung cấp là opaque.
• Các trang web cấp cao nhất và nhúng không nằm trong cùng bộ trang web liên quan.
• <iframe> nhúng bị sandbox và token allow-storage-access-by-user-activation không được đặt.
• Việc sử dụng bị chặn bởi storage-access Permissions Policy.
• Việc sử dụng bị tác nhân người dùng từ chối bởi yêu cầu quyền sử dụng API.

TypeError

Được ném nếu requestedOrigin không phải là một URL hợp lệ.

Mô tả

Phương thức requestStorageAccessFor() giải quyết các thách thức trong việc áp dụng Storage Access API trên các trang web cấp cao nhất sử dụng hình ảnh hoặc tập lệnh khác trang web yêu cầu cookie. Nó liên quan đến các tác nhân người dùng theo mặc định chặn quyền truy cập vào cookie bên thứ ba, không phân vùng để cải thiện quyền riêng tư (ví dụ: để ngăn chặn theo dõi), và là một phần mở rộng được đề xuất của Storage Access API.

requestStorageAccessFor() có thể cho phép truy cập cookie bên thứ ba cho các tài nguyên khác trang web được nhúng trực tiếp vào một trang web cấp cao nhất mà không thể tự yêu cầu quyền truy cập storage, ví dụ các phần tử <img>. Nội dung khác trang web được nhúng trong <iframe> có logic và tài nguyên riêng và cần quyền truy cập cookie bên thứ ba nên yêu cầu quyền truy cập storage thông qua Document.requestStorageAccess().

Để kiểm tra xem quyền truy cập cookie bên thứ ba đã được cấp thông qua requestStorageAccessFor() hay chưa, bạn có thể gọi Permissions.query(), chỉ định tên tính năng "top-level-storage-access". Điều này khác với tên tính năng được sử dụng cho phương thức Document.requestStorageAccess() thông thường, là "storage-access".

Lệnh gọi Permissions.query() phải chỉ định nguồn gốc nhúng; ví dụ:

navigator.permissions.query({
  name: "top-level-storage-access",
  requestedOrigin: "https://www.example.com",
});

Ví dụ

function rSAFor() {
  if ("requestStorageAccessFor" in document) {
    document.requestStorageAccessFor("https://example.com").then(
      (res) => {
        // Sử dụng quyền truy cập storage
        doThingsWithCookies();
      },
      (err) => {
        // Xử lý lỗi
      },
    );
  }
}

Sau một lệnh gọi requestStorageAccessFor() thành công, các yêu cầu khác trang web sẽ bao gồm cookie nếu chúng bao gồm CORS / crossorigin, do đó các trang web có thể muốn đợi trước khi kích hoạt yêu cầu. Các yêu cầu như vậy phải sử dụng tùy chọn credentials: "include" và tài nguyên phải bao gồm thuộc tính crossorigin="use-credentials".

Ví dụ:

function checkCookie() {
  fetch("https://example.com/getcookies.json", {
    method: "GET",
    credentials: "include",
  })
    .then((response) => response.json())
    .then((json) => {
      // Làm gì đó
    });
}

Đặc tả kỹ thuật

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

Xem thêm

• Document.hasStorageAccess(), Document.hasUnpartitionedCookieAccess(), Document.requestStorageAccess()
• Sử dụng Storage Access API
• Introducing Storage Access API (bài viết WebKit)