Window: showSaveFilePicker() Methode

Syntax

showSaveFilePicker()
showSaveFilePicker(options)

Parameter

options Optional

Ein Objekt, das Optionen enthlt, die wie folgt sind:

excludeAcceptAllOption Optional

Ein Boolescher Wert, der standardmig auf false gesetzt ist. Standardmig sollte der Picker eine Option enthalten, um keine Dateitypenfilter anzuwenden (ausgelst durch die untenstehende Typoption). Wenn diese Option auf true gesetzt wird, ist diese Option nicht verfgbar.

id Optional

Durch die Angabe einer ID kann sich der Browser verschiedene Verzeichnisse fr verschiedene IDs merken. Wenn dieselbe ID fr einen anderen Picker verwendet wird, ffnet sich der Picker im selben Verzeichnis.

startIn Optional

Ein FileSystemHandle oder ein bekanntes Verzeichnis ("desktop", "documents", "downloads", "music", "pictures" oder "videos") um den Dialog darin zu ffnen.

suggestedName Optional

Ein String. Der vorgeschlagene Dateiname.

types Optional

Ein Array der erlaubten Dateitypen zum Speichern. Jedes Element ist ein Objekt mit den folgenden Optionen:

description Optional

Eine optionale Beschreibung der Kategorie der erlaubten Dateitypen. Standardwert ist ein leerer String.

accept

Ein Object mit den Schlsseln, die auf den MIME-Typen eingestellt sind, und den Werten, die ein Array von Dateierweiterungen sind (siehe unten fr ein Beispiel).

Rckgabewert

Ein Promise, dessen Erfllungshandler ein FileSystemFileHandle-Objekt erhlt.

Ausnahmen

AbortError DOMException

Wird ausgelst, wenn der Benutzer den Dateiauswahldialog ohne Auswahl oder Eingabe einer Datei schliet oder wenn der Benutzeragent eine ausgewhlte Datei als zu sensibel oder gefhrlich einstuft.

SecurityError DOMException

Wird ausgelst, wenn der Aufruf durch die Same-Origin-Policy blockiert wurde oder wenn er nicht durch eine Benutzerinteraktion wie einen Tastendruck ausgelst wurde.

TypeError

Wird ausgelst, wenn Akzeptanztypen nicht verarbeitet werden knnen, was passieren kann, wenn:

• Ein Schlsselstring der accept-Optionen eines Elements in den types-Optionen keinen gltigen MIME-Typ parsen kann.
• Ein Wertstring der accept-Optionen eines Elements in den types-Optionen ungltig ist, zum Beispiel, wenn er nicht mit . beginnt, mit . endet oder ungltige Codepunkte enthlt und seine Lnge mehr als 16 ist.
• Die types-Optionen leer sind und die excludeAcceptAllOption-Optionen true sind.

Sicherheit

Eine vorbergehende Benutzerauslsung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.

Beispiele

Die folgende Funktion zeigt einen Dateiauswahldialog, wobei Textdateien zur Auswahl hervorgehoben sind.

async function getNewFileHandle() {
  const opts = {
    types: [
      {
        description: "Text file",
        accept: { "text/plain": [".txt"] },
      },
    ],
  };
  return await window.showSaveFilePicker(opts);
}

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• File System API
• The File System Access API: simplifying access to local files