FileSystemHandle: phương thức requestPermission()

Cú pháp

requestPermission(descriptor)

Tham số

descriptor Optional

Một object chỉ định chế độ quyền cần truy vấn. Các tùy chọn như sau:

'mode' Optional

Có thể là 'read', 'write' hoặc 'readwrite'.

Giá trị trả về

Một Promise được resolve với PermissionStatus.state là một trong 'granted', 'denied' hoặc 'prompt'. Nó cũng có thể reject với một trong các ngoại lệ bên dưới.

Ngoại lệ

TypeError

Được ném ra nếu không chỉ định tham số nào hoặc mode không phải là 'read', 'write' hoặc 'readwrite'.

SecurityError DOMException

Được ném ra trong một trong các trường hợp sau:

• Phương thức được gọi trong ngữ cảnh không cùng origin với ngữ cảnh cấp cao nhất, tức một iframe khác origin.
• Không có kích hoạt người dùng tạm thời, chẳng hạn một lần nhấn nút. Điều này bao gồm cả trường hợp handle nằm trong ngữ cảnh không phải Window không thể tiêu thụ kích hoạt người dùng, chẳng hạn worker.

Bảo mật

Yêu cầu có kích hoạt người dùng tạm thời. Người dùng phải tương tác với trang hoặc một phần tử giao diện để tính năng này hoạt động.

Ví dụ

Hàm bất đồng bộ sau yêu cầu quyền nếu chúng chưa được cấp.

// fileHandle là một FileSystemFileHandle
// withWrite là một boolean được đặt thành true nếu muốn ghi

async function verifyPermission(fileHandle, withWrite) {
  const opts = {};
  if (withWrite) {
    opts.mode = "readwrite";
  }

  // Kiểm tra xem chúng ta đã có quyền chưa, nếu có thì trả về true.
  if ((await fileHandle.queryPermission(opts)) === "granted") {
    return true;
  }

  // Yêu cầu quyền với file, nếu người dùng cấp quyền thì trả về true.
  if ((await fileHandle.requestPermission(opts)) === "granted") {
    return true;
  }

  // Người dùng không cấp quyền, trả về false.
  return false;
}

Thông số kỹ thuật

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

Xem thêm

• File System API
• File System Access API: đơn giản hóa truy cập tới file cục bộ