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, bevor Sie diese produktiv verwenden.

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

Syntax

js
showDirectoryPicker()

Parameter

options Optional

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

id Optional

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

mode Optional

Eine Zeichenkette, die 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 den Dialog 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-Policy blockiert wurde oder nicht durch eine Benutzerinteraktion wie das Drücken eines Buttons erfolgt ist.

Sicherheit

Eine 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.

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

  // run code for dirHandle
}

Spezifikationen

Specification
File System Access
# api-showdirectorypicker

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch