Window: Methode showDirectoryPicker()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 Methode showDirectoryPicker() der Schnittstelle
Window zeigt einen Verzeichnisauswahldialog an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.
Syntax
showDirectoryPicker()
showDirectoryPicker(options)
Parameter
optionsOptional-
Ein Objekt mit Optionen, die wie folgt lauten:
idOptional-
Durch die Angabe einer ID kann der Browser verschiedene Verzeichnisse für unterschiedliche IDs speichern. Wenn dieselbe ID für einen anderen Auswahldialog verwendet wird, wird dieser im selben Verzeichnis geöffnet.
modeOptional-
Ein String, der standardmäßig
"read"für schreibgeschützten Zugriff oder"readwrite"für Lese- und Schreibzugriff auf das Verzeichnis verwendet. startInOptional-
Ein
FileSystemHandleoder ein bekanntes Verzeichnis ("desktop","documents","downloads","music","pictures"oder"videos"), in dem der Dialog geöffnet wird.
Rückgabewert
Ein Promise, dessen Erfüllungs-Handler ein FileSystemDirectoryHandle-Objekt erhält.
Ausnahmen
AbortErrorDOMException-
Wird ausgelöst, wenn der Benutzer die Eingabeaufforderung schließt, ohne eine Auswahl zu treffen, oder wenn der User-Agent das ausgewählte Verzeichnis als zu sensibel oder gefährlich einstuft, oder wenn der
PermissionStatus.statefür das ausgewählte Verzeichnis im angegebenenmodenicht"granted"ist. SecurityErrorDOMException-
Wird ausgelöst, wenn der Aufruf durch die Same-Origin-Policy blockiert wurde oder nicht durch eine Benutzerinteraktion wie das Drücken einer Schaltfläche aufgerufen wurde.
Sicherheit
Eine vorübergehende Benutzeraktivierung ist erforderlich. Damit diese Funktion funktioniert, muss der Benutzer mit der Seite oder einem UI-Element interagieren.
Beispiele
Diese asynchrone Funktion zeigt einen Verzeichnisauswahldialog an und gibt nach der Auswahl einen
FileSystemDirectoryHandle zurück.
async function getDir() {
const dirHandle = await window.showDirectoryPicker();
// run code for dirHandle
}
Spezifikationen
| Spezifikation |
|---|
| File System Access # api-showdirectorypicker |