Window: showDirectoryPicker() Methode

Syntax

showDirectoryPicker()
showDirectoryPicker(options)

Parameter

options Optional

Ein Objekt, das Optionen enthält, wie folgt:

id Optional

Durch die Angabe einer ID kann der Browser verschiedene Verzeichnisse für verschiedene IDs merken. Wenn dieselbe ID für einen anderen Auswahldialog verwendet wird, öffnet sich der Dialog im selben Verzeichnis.

mode Optional

Ein String, der standardmäßig auf "read" für schreibgeschützten Zugriff oder "readwrite" für Lese- und Schreibzugriff auf das Verzeichnis eingestellt ist.

startIn Optional

Ein FileSystemHandle oder ein bekanntes Verzeichnis ("desktop", "documents", "downloads", "music", "pictures", oder "videos"), in dem der Dialog geöffnet werden soll.

Rückgabewert

Ein Promise, dessen Fulfillment-Handler ein FileSystemDirectoryHandle-Objekt erhält.

Ausnahmen

AbortError DOMException

Wird ausgelöst, wenn der Benutzer das Dialogfeld schließt, ohne eine Auswahl zu treffen, oder wenn der Benutzeragent das ausgewählte Verzeichnis als zu sensibel oder gefährlich erachtet, oder wenn der PermissionStatus.state für das ausgewählte Verzeichnis nicht "granted" im angegebenen mode ist.

SecurityError DOMException

Wird ausgelöst, wenn der Aufruf durch die Same-Origin-Richtlinie blockiert wurde oder nicht durch eine Benutzerinteraktion wie einen Tastendruck ausgeführt wurde.

Sicherheit

Flüchtige Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.

Beispiele

Diese asynchrone Funktion zeigt einen Verzeichnisauswahldialog an und gibt ein FileSystemDirectoryHandle zurück, sobald eine Auswahl getroffen wurde.

async function getDir() {
  const dirHandle = await window.showDirectoryPicker();

  // run code for dirHandle
}

Spezifikationen

Browser-Kompatibilität

Siehe auch

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