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 des
Window-Interfaces zeigt einen Verzeichnis-Auswahldialog, der es dem Benutzer erlaubt, ein Verzeichnis auszuwählen.
Syntax
showDirectoryPicker()
showDirectoryPicker(options)
Parameter
optionsOptional-
Ein Objekt, das Optionen enthält, die wie folgt sind:
idOptional-
Durch das Angeben einer ID kann sich der Browser unterschiedliche Verzeichnisse für verschiedene IDs merken. Wenn dieselbe ID für einen anderen Auswahldialog verwendet wird, öffnet sich der Dialog im selben Verzeichnis.
modeOptional-
Ein String, der standardmäßig auf
"read"für Lesezugriff oder"readwrite"für Lese- und Schreibzugriff auf das Verzeichnis gesetzt ist. startInOptional-
Ein
FileSystemHandleoder ein bekanntes Verzeichnis ("desktop","documents","downloads","music","pictures"oder"videos"), in dem der Dialog geöffnet werden soll.
Rückgabewert
Ein Promise, dessen Erfüllungs-Handler ein FileSystemDirectoryHandle-Objekt empfängt.
Ausnahmen
AbortErrorDOMException-
Wird ausgelöst, wenn der Benutzer den Dialog ohne Auswahl schließt, oder wenn der Benutzeragent das ausgewählte Verzeichnis als zu sensibel oder gefährlich betrachtet, oder wenn der
PermissionStatus.statefür das ausgewählte Verzeichnis nicht"granted"im angegebenenmodeist. SecurityErrorDOMException-
Wird ausgelöst, wenn der Aufruf durch die Same-Origin-Policy blockiert wurde oder wenn er nicht über eine Benutzerinteraktion wie einen Tastendruck erfolgt ist.
Sicherheit
Vorübergehende Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.
Beispiele
Diese asynchrone Funktion zeigt einen Verzeichnis-Auswahldialog und gibt ein
FileSystemDirectoryHandle zurück, sobald ein Verzeichnis ausgewählt wurde.
async function getDir() {
const dirHandle = await window.showDirectoryPicker();
// run code for dirHandle
}
Spezifikationen
| Specification |
|---|
| File System Access # api-showdirectorypicker |