Window : méthode showDirectoryPicker()
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
La méthode showDirectoryPicker() de l'interface Window affiche un sélecteur de répertoires permettant à l'utilisateur·ice de sélectionner un répertoire.
Syntaxe
showDirectoryPicker()
showDirectoryPicker(options)
Paramètres
optionsFacultatif-
Un objet contenant des options, qui sont les suivantes :
idFacultatif-
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.
modeFacultatif-
Une chaîne de caractères qui vaut par défaut
"read"pour un accès en lecture seule ou"readwrite"pour un accès en lecture et écriture au répertoire. startInFacultatif-
Un objet
FileSystemHandleou un répertoire bien connu ("desktop","documents","downloads","music","pictures"ou"videos") pour ouvrir la boîte de dialogue dans ce répertoire.
Valeur de retour
Une promesse (Promise) dont le gestionnaire de complétion reçoit un objet FileSystemDirectoryHandle.
Exceptions
AbortErrorDOMException-
Levée si l'utilisateur·ice ferme la boîte de dialogue sans faire de sélection, ou si l'agent utilisateur juge que le répertoire sélectionné est trop sensible ou dangereux, ou si le
PermissionStatus.statepour le répertoire sélectionné n'est pas"granted"dans lemodedéfini. SecurityErrorDOMException-
Levée si l'appel a été bloqué par la politique de même origine ou s'il n'a pas été effectué par une interaction utilisateur·ice telle qu'un clic sur un bouton.
Sécurité
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
Cette fonction asynchrone affiche un sélecteur de répertoires et retourne un FileSystemDirectoryHandle une fois le répertoire sélectionné.
async function obtenirRepertoire() {
const gestionnaireRepertoire = await window.showDirectoryPicker();
// exécuter le code de gestionnaireRepertoire
}
Spécifications
| Spécification |
|---|
| File System Access # api-showdirectorypicker |