FileSystemHandle: requestPermission() Methode

descriptor Optional

Ein Objekt, das den Abfragemodus für die Berechtigung angibt. Optionen sind wie folgt:

'mode' Optional

Kann entweder 'read' oder 'readwrite' sein.

Ein Promise, das mit PermissionStatus.state aufgelöst wird, was einer der Werte 'granted', 'denied' oder 'prompt' ist. Es kann auch mit einer der unten aufgeführten Ausnahmen abgelehnt werden.

TypeError

Wird ausgelöst, wenn kein Parameter angegeben ist oder der mode nicht 'read' 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 (z.B. ein Cross-Origin-IFrame).
• Es gab keine transiente Benutzeraktivierung wie das Drücken einer Taste. Dies umfasst auch, wenn der Handle sich in einem nicht-Fenster-Kontext befindet, der keine Benutzeraktivierung konsumieren kann, wie etwa ein Worker.

Transiente Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit dieses Feature funktioniert.

Die folgende asynchrone Funktion fordert Berechtigungen an, wenn 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
• Die File System Access API: Vereinfachter Zugriff auf lokale Dateien