Window: Methode showSaveFilePicker()
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 showSaveFilePicker() des Interfaces
Window zeigt eine Dateiauswahl an, mit der eine Benutzerin oder ein Benutzer eine Datei speichern kann.
Dies kann durch Auswahl einer vorhandenen Datei oder durch Eingabe eines Namens für eine neue Datei erfolgen.
Syntax
showSaveFilePicker()
showSaveFilePicker(options)
Parameter
optionsOptional-
Ein Objekt, das Optionen enthält. Diese sind wie folgt:
excludeAcceptAllOptionOptional-
Ein boolescher Wert, der standardmäßig auf
falsegesetzt ist. Standardmäßig sollte die Auswahl eine Option enthalten, um keine Dateitypfilter anzuwenden (ausgelöst durch die untenstehende Typoption). Wenn diese Option auftruegesetzt wird, ist diese Option nicht verfügbar. idOptional-
Durch Angabe einer ID kann der Browser verschiedene Verzeichnisse für verschiedene IDs speichern. Wenn dieselbe ID für eine andere Auswahl verwendet wird, wird die Auswahl im selben Verzeichnis geöffnet.
startInOptional-
Ein
FileSystemHandleoder ein bekanntes Verzeichnis ("desktop","documents","downloads","music","pictures"oder"videos"), in dem der Dialog geöffnet werden soll. suggestedNameOptional-
Ein
String. Der vorgeschlagene Dateiname. typesOptional-
Ein
Arrayzulässiger Dateitypen zum Speichern. Jedes Element ist ein Objekt mit den folgenden Optionen:descriptionOptional-
Eine optionale Beschreibung der Kategorie zulässiger Dateitypen. Standardmäßig eine leere Zeichenkette.
accept-
Ein
Object, dessen Schlüssel auf den MIME-Typ gesetzt sind und dessen Werte einArrayvon Dateierweiterungen sind (siehe unten ein Beispiel).
Rückgabewert
Ein Promise, dessen Fulfillment-Handler ein FileSystemFileHandle-Objekt erhält.
Ausnahmen
AbortErrorDOMException-
Wird ausgelöst, wenn die Benutzerin oder der Benutzer die Dateiauswahl schließt, ohne eine Datei auszuwählen oder einzugeben, oder wenn der User Agent ausgewählte Dateien als zu sensibel oder gefährlich einstuft.
SecurityErrorDOMException-
Wird ausgelöst, wenn der Aufruf durch die Same-Origin-Policy blockiert wurde oder nicht über eine Benutzerinteraktion wie einen Tastendruck auf eine Schaltfläche erfolgte.
TypeError-
Wird ausgelöst, wenn Accept-Typen nicht verarbeitet werden können. Dies kann auftreten, wenn:
- Eine beliebige Schlüsselzeichenkette der
accept-Optionen eines beliebigen Elements in dentypes-Optionen nicht als gültiger MIME-Typ geparst werden kann. - Eine oder mehrere Wertzeichenketten der
accept-Optionen eines beliebigen Elements in dentypes-Optionen ungültig sind, beispielsweise wenn sie nicht mit.beginnen und mit.enden oder wenn sie ungültige Codepunkte enthalten und länger als 16 Zeichen sind. - Die
types-Optionen leer sind und dieexcludeAcceptAllOption-Optionen auftruegesetzt sind.
- Eine beliebige Schlüsselzeichenkette der
Sicherheit
Eine vorübergehende Benutzeraktivierung ist erforderlich. Damit dieses Feature funktioniert, muss die Benutzerin oder der Benutzer mit der Seite oder einem UI-Element interagieren.
Beispiele
Die folgende Funktion zeigt eine Dateiauswahl an, bei der Textdateien zur Auswahl hervorgehoben werden.
async function getNewFileHandle() {
const opts = {
types: [
{
description: "Text file",
accept: { "text/plain": [".txt"] },
},
],
};
return await window.showSaveFilePicker(opts);
}
Spezifikationen
| Spezifikation |
|---|
| File System Access # api-showsavefilepicker |