Window : méthode showSaveFilePicker()

Syntaxe

showSaveFilePicker()
showSaveFilePicker(options)

Paramètres

options Facultatif

Un objet contenant des options, qui sont les suivantes :

excludeAcceptAllOption Facultatif

Une valeur booléenne qui par défaut est false. Par défaut, le sélecteur doit inclure une option pour ne pas appliquer de filtres de type de fichier (instiguée avec l'option type ci-dessous). Définir cette option sur true signifie que cette option n'est pas disponible.

id Facultatif

Par définition d'un identifiant, le navigateur peut se souvenir de différents répertoires pour différents identifiants. Si le même identifiant est utilisé pour un autre sélecteur, le sélecteur s'ouvre dans le même répertoire.

startIn Facultatif

Un objet FileSystemHandle ou un répertoire bien connu ("desktop", "documents", "downloads", "music", "pictures" ou "videos") pour ouvrir la boîte de dialogue.

suggestedName Facultatif

Une chaîne de caractères (String). Le nom de fichier suggéré.

types Facultatif

Un tableau (Array) des types de fichiers autorisés à sauvegarder. Chaque élément est un objet avec les options suivantes :

description Facultatif

Une description optionnelle de la catégorie des types de fichiers autorisés. Par défaut, une chaîne de caractères vide.

accept

Un Object dont les clés sont les types MIME et les valeurs un tableau (Array) d'extensions de fichiers (voir ci-dessous pour un exemple).

Valeur de retour

Une promesse (Promise) dont le gestionnaire de complétion reçoit un objet FileSystemFileHandle.

Exceptions

AbortError DOMException

Levée si l'utilisateur·ice ferme le sélecteur de fichiers sans sélectionner ou saisir un fichier, ou si l'agent utilisateur juge que les fichiers sélectionnés sont trop sensibles ou dangereux.

SecurityError DOMException

Levée si l'appel a été bloqué par la politique de même origine ou s'il n'a pas été effectué p une interaction utilisateur·ice telle qu'un clic sur un bouton.

TypeError

Levée si les types acceptés ne peuvent pas être traités, ce qui peut se produire si :

• Toute chaîne de caractères clé des options accept de n'importe quel élément dans les options types ne peut pas être analysée en un type MIME valide.
• Toute chaîne de caractères valeur des options accept de n'importe quel élément dans les options types est invalide, par exemple, si elle ne commence pas par . et se termine par ., ou si elle contient des points de code invalides et que sa longueur est supérieure à 16.
• Les options types sont vides et les options excludeAcceptAllOption sont true.

Sécurité

Une activation utilisateur transitoire est requise. L'utilisateur·ice doit interagir avec la page ou un élément de l'interface utilisateur pour que cette fonctionnalité fonctionne.

Exemples

La fonction suivante affiche un sélecteur de fichiers, avec les fichiers texte mis en évidence pour la sélection.

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

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'API File System
• L'API File System Access : simplification de l'accès aux fichiers locaux ^(angl.)