Window: showDirectoryPicker() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die showDirectoryPicker()-Methode der Window-Schnittstelle zeigt einen Verzeichnisauswahldialog an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.

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

Specification
File System Access # api-showdirectorypicker