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 Ordnerauswahldialog an, der es dem Benutzer ermöglicht, ein Verzeichnis auszuwählen.

Syntax

showDirectoryPicker()
showDirectoryPicker(options)

Parameter

options Optional

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

id Optional: Durch Angabe einer ID kann der Browser unterschiedliche Verzeichnisse für verschiedene IDs speichern. Wird dieselbe ID für einen anderen Picker verwendet, öffnet sich dieser im gleichen Verzeichnis.
mode Optional: Ein String, der standardmäßig auf "read" für Nur-Lese-Zugriff oder "readwrite" für Lese- und Schreibzugriff auf das Verzeichnis gesetzt ist.
startIn Optional: Ein FileSystemHandle oder ein bekanntes Verzeichnis ("desktop", "documents", "downloads", "music", "pictures", oder "videos"), um den Dialog in diesem Verzeichnis zu öffnen.

Rückgabewert

Ein Promise, dessen Übernahmebehandler ein FileSystemDirectoryHandle-Objekt erhält.

Ausnahmen

AbortError DOMException: Wird ausgelöst, wenn der Benutzer die Eingabeaufforderung ohne Auswahl schließt, oder wenn der User-Agent das ausgewählte Verzeichnis als zu sensibel oder gefährlich einstuft, 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-Policy blockiert wurde oder nicht durch eine Benutzerinteraktion wie einen Tastendruck aufgerufen wurde.

Sicherheit

Transient user activation ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.

Beispiele

Diese asynchrone Funktion zeigt einen Ordnerauswahldialog 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