FileSystemHandle: requestPermission() Methode

descriptor Optional

Ein Objekt, das den Berechtigungsmodus spezifiziert, der abgefragt werden soll. Die Optionen sind wie folgt:

'mode' Optional

Kann entweder 'read', 'write' oder 'readwrite' sein.

Ein Promise, das mit PermissionStatus.state aufgelöst wird, was entweder 'granted', 'denied' oder 'prompt' ist. Es kann auch mit einer der untenstehenden Ausnahmen fehlschlagen.

TypeError

Wird ausgelöst, wenn kein Parameter angegeben wird oder der mode nicht 'read', 'write', oder 'readwrite' ist.

SecurityError DOMException

Wird in einem der folgenden Fälle ausgelöst:

• Die Methode wurde in einem Kontext aufgerufen, der nicht same-origin mit dem Top-Level-Kontext ist (d.h. eine Cross-Origin-iframe).
• Es gab keine vorübergehende Benutzeraktivierung wie einen Tastendruck. Dies schließt ein, wenn das Handle sich in einem Nicht-Window-Kontext befindet, der keine Benutzeraktivierung konsumieren kann, wie etwa ein Worker.

Vorübergehende Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion arbeitet.

Die folgende asynchrone Funktion fordert Berechtigungen an, falls diese nicht bereits erteilt wurden.

// fileHandle is a FileSystemFileHandle
// withWrite is a boolean set to true if write

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

  // Check if we already have permission, if so, return true.
  if ((await fileHandle.queryPermission(opts)) === "granted") {
    return true;
  }

  // Request permission to the file, if the user grants permission, return true.
  if ((await fileHandle.requestPermission(opts)) === "granted") {
    return true;
  }

  // The user did not grant permission, return false.
  return false;
}

• File System API
• The File System Access API: simplifying access to local files