Enregistrez une application en tant que gestionnaire de fichiers auprès du système d'exploitation.
Maintenant que les applications Web peuvent lire et écrire des fichiers, l'étape logique suivante consiste à permettre aux développeurs de déclarer ces applications Web en tant que gestionnaires de fichiers pour les fichiers que leurs applications peuvent créer et traiter. L'API File Handling vous permet de le faire. Après avoir enregistré une application d'éditeur de texte en tant que gestionnaire de fichiers et l'avoir installée, vous pouvez faire un clic droit sur un fichier .txt
sous macOS et sélectionner "Get Info" (Obtenir des informations) pour indiquer à l'OS qu'il doit toujours ouvrir les fichiers .txt
avec cette application par défaut.
Cas d'utilisation suggérés pour l'API File Handling
Voici quelques exemples de sites qui peuvent utiliser cette API:
- Applications Office telles que les éditeurs de texte, les applications de feuilles de calcul et les outils de création de diapositives
- Éditeurs graphiques et outils de dessin
- Outils d'édition de niveaux de jeux vidéo.
Utiliser l'API File Handling
Amélioration progressive
L'API File Handling ne peut pas être polyfilled. Cependant, la fonctionnalité d'ouverture de fichiers avec une application Web peut être obtenue de deux autres manières:
- L'API Web Share Target permet aux développeurs de spécifier leur application comme cible de partage afin que les fichiers puissent être ouverts depuis la feuille de partage du système d'exploitation.
- L'API File System Access peut être intégrée au glisser-déposer de fichiers, afin que les développeurs puissent gérer les fichiers déposés dans l'application déjà ouverte.
Prise en charge des navigateurs
Détection de fonctionnalités
Pour vérifier si l'API File Handling est prise en charge, utilisez:
if ('launchQueue' in window && 'files' in LaunchParams.prototype) {
// The File Handling API is supported.
}
Partie déclarative de l'API File Handling
Dans un premier temps, les applications Web doivent décrire de manière déclarative dans leur fichier manifeste d'application Web les types de fichiers qu'elles peuvent gérer. L'API File Handling étend le fichier manifeste de l'application Web avec une nouvelle propriété appelée "file_handlers"
, qui accepte un tableau de gestionnaires de fichiers. Un gestionnaire de fichiers est un objet doté des propriétés suivantes:
- Une propriété
"action"
qui pointe vers une URL comprise dans le champ d'application de l'application comme valeur. - Propriété
"accept"
avec un objet de types MIME comme clés et des listes d'extensions de fichier comme valeurs. - Propriété
"icons"
avec un tableau d'icônesImageResource
. Certains systèmes d'exploitation permettent d'afficher une icône associée à un type de fichier qui n'est pas seulement l'icône de l'application associée, mais plutôt une icône spéciale liée à l'utilisation de ce type de fichier avec l'application. - Propriété
"launch_type"
qui définit si plusieurs fichiers doivent être ouverts dans un seul client ou dans plusieurs clients. La valeur par défaut est"single-client"
. Si l'utilisateur ouvre plusieurs fichiers et si le gestionnaire de fichiers a été annoté avec"multiple-clients"
comme"launch_type"
, plusieurs lancements d'applications se produiront. Pour chaque lancement, le tableauLaunchParams.files
(voir plus loin) ne contiendra qu'un seul élément.
L'exemple ci-dessous, qui n'affiche que l'extrait pertinent du fichier manifeste de l'application Web, devrait le rendre plus clair:
{
"file_handlers": [
{
"action": "/open-csv",
"accept": {
"text/csv": [".csv"]
},
"icons": [
{
"src": "csv-icon.png",
"sizes": "256x256",
"type": "image/png"
}
],
"launch_type": "single-client"
},
{
"action": "/open-svg",
"accept": {
"image/svg+xml": ".svg"
},
"icons": [
{
"src": "svg-icon.png",
"sizes": "256x256",
"type": "image/png"
}
],
"launch_type": "single-client"
},
{
"action": "/open-graf",
"accept": {
"application/vnd.grafr.graph": [".grafr", ".graf"],
"application/vnd.alternative-graph-app.graph": ".graph"
},
"icons": [
{
"src": "graf-icon.png",
"sizes": "256x256",
"type": "image/png"
}
],
"launch_type": "multiple-clients"
}
]
}
Il s'agit d'une application hypothétique qui gère les fichiers de valeurs séparées par des virgules (.csv
) à /open-csv
, les fichiers de graphiques vectoriels évolutifs (.svg
) à /open-svg
et un format de fichier Grafr fictif avec l'extension .grafr
, .graf
ou .graph
à /open-graf
. Les deux premiers s'ouvrent dans un seul client, le dernier dans plusieurs clients si plusieurs fichiers sont gérés.
Partie impérative de l'API File Handling
Maintenant que l'application a déclaré les fichiers qu'elle peut gérer à quelle URL de portée en théorie, elle doit impérativement faire quelque chose avec les fichiers entrants en pratique. C'est là que launchQueue
entre en jeu. Pour accéder aux fichiers lancés, un site doit spécifier un consommateur pour l'objet window.launchQueue
. Les lancements sont mis en file d'attente jusqu'à ce qu'ils soient gérés par le consommateur spécifié, qui est appelé exactement une fois pour chaque lancement. De cette manière, chaque lancement est géré, quel que soit le moment où le consommateur a été spécifié.
if ('launchQueue' in window && 'files' in LaunchParams.prototype) {
launchQueue.setConsumer((launchParams) => {
// Nothing to do when the queue is empty.
if (!launchParams.files.length) {
return;
}
for (const fileHandle of launchParams.files) {
// Handle the file.
}
});
}
Compatibilité avec les outils de développement
Les DevTools ne sont pas compatibles pour le moment, mais j'ai envoyé une demande de fonctionnalité pour que cette compatibilité soit ajoutée.
Démo
J'ai ajouté la prise en charge de la gestion des fichiers à Excalidraw, une application de dessin de style cartoon. Pour le tester, vous devez d'abord installer Excalidraw. Lorsque vous créez un fichier avec celui-ci et le stockez quelque part dans votre système de fichiers, vous pouvez l'ouvrir en double-cliquant dessus ou en effectuant un clic droit, puis en sélectionnant "Excalidraw" dans le menu contextuel. Vous pouvez consulter l'implémentation dans le code source.
Sécurité
L'équipe Chrome a conçu et mis en œuvre l'API File Handling à l'aide des principes fondamentaux définis dans la section Contrôler l'accès à des fonctionnalités puissantes de la plate-forme Web, y compris le contrôle utilisateur, la transparence et l'ergonomie.
Autorisations, persistance des autorisations et mises à jour du gestionnaire de fichiers
Pour garantir la confiance des utilisateurs et la sécurité de leurs fichiers, lorsqu'une PWA ouvre un fichier, une invite d'autorisation s'affiche avant que la PWA puisse afficher le fichier. Cette invite d'autorisation s'affiche immédiatement après que l'utilisateur a sélectionné la PWA pour ouvrir un fichier. L'autorisation est ainsi étroitement associée à l'action d'ouverture d'un fichier à l'aide de la PWA, ce qui la rend plus claire et pertinente.
Cette autorisation s'affiche à chaque fois jusqu'à ce que l'utilisateur clique sur Autoriser ou Bloquer la gestion des fichiers pour le site, ou ignore l'invite trois fois (après quoi Chromium imposera un embargo et bloquera cette autorisation). Le paramètre sélectionné sera conservé même après la fermeture et la réouverture de la PWA.
Lorsque le fichier manifeste est mis à jour et que des modifications sont détectées dans la section "file_handlers"
, les autorisations sont réinitialisées.
Problèmes liés aux fichiers
Une grande catégorie de vecteurs d'attaque s'ouvre en autorisant les sites Web à accéder aux fichiers. Ces éléments sont décrits dans l'article sur l'API File System Access. La fonctionnalité de sécurité supplémentaire fournie par l'API File Handling par rapport à l'API File System Access est la possibilité d'accorder l'accès à certains fichiers via l'interface utilisateur intégrée du système d'exploitation, par opposition à un sélecteur de fichier affiché par une application Web.
Les utilisateurs peuvent toujours accorder involontairement à une application Web l'accès à un fichier lorsqu'ils l'ouvrent. Toutefois, il est généralement admis que l'ouverture d'un fichier permet à l'application avec laquelle il est ouvert de le lire et/ou de le manipuler. Par conséquent, le choix explicite d'un utilisateur d'ouvrir un fichier dans une application installée, par exemple via un menu contextuel "Ouvrir avec…", peut être interprété comme un signal de confiance suffisant dans l'application.
Défis liés au gestionnaire par défaut
L'exception est que le système hôte ne contient aucune application pour un type de fichier donné. Dans ce cas, certains systèmes d'exploitation hôtes peuvent automatiquement promouvoir le nouveau gestionnaire enregistré en tant que gestionnaire par défaut pour ce type de fichier de manière silencieuse et sans intervention de l'utilisateur. Cela signifie que si l'utilisateur double-clique sur un fichier de ce type, il s'ouvre automatiquement dans l'application Web enregistrée. Sur ces systèmes d'exploitation hôtes, lorsque le user-agent détermine qu'il n'existe pas de gestionnaire par défaut pour le type de fichier, une demande d'autorisation explicite peut être nécessaire pour éviter d'envoyer accidentellement le contenu d'un fichier à une application Web sans le consentement de l'utilisateur.
Contrôle des utilisateurs
La spécification indique que les navigateurs ne doivent pas enregistrer chaque site pouvant gérer des fichiers en tant que gestionnaire de fichiers. Au lieu de cela, l'enregistrement de la gestion des fichiers doit être limité à l'installation et ne jamais se produire sans confirmation explicite de l'utilisateur, en particulier si un site doit devenir le gestionnaire par défaut. Plutôt que de détourner des extensions existantes telles que .json
pour lesquelles l'utilisateur dispose probablement déjà d'un gestionnaire par défaut enregistré, les sites doivent envisager de créer leurs propres extensions.
Transparence
Tous les systèmes d'exploitation permettent aux utilisateurs de modifier les associations de fichiers actuelles. Ceci est en dehors du champ d'application du navigateur.
Commentaires
L'équipe Chrome souhaite connaître votre expérience avec l'API File Handling.
Parlez-nous de la conception de l'API
L'API ne fonctionne-t-elle pas comme prévu ? Ou manque-t-il des méthodes ou des propriétés dont vous avez besoin pour implémenter votre idée ? Vous avez une question ou un commentaire sur le modèle de sécurité ?
- Signalez un problème de spécification dans le dépôt GitHub correspondant ou ajoutez vos commentaires à un problème existant.
Signaler un problème d'implémentation
Avez-vous détecté un bug dans l'implémentation de Chrome ? Ou l'implémentation est-elle différente des spécifications ?
- Signalez un bug sur new.crbug.com. Veillez à inclure autant de détails que possible et des instructions simples pour reproduire le bug, et saisissez
UI>Browser>WebAppInstalls>FileHandling
dans la zone Composants. Glitch est idéal pour partager des répétitions rapidement et facilement.
Afficher la compatibilité avec l'API
Prévoyez-vous d'utiliser l'API File Handling ? Votre soutien public aide l'équipe Chrome à hiérarchiser les fonctionnalités et montre aux autres fournisseurs de navigateurs à quel point il est essentiel de les prendre en charge.
- Expliquez comment vous prévoyez de l'utiliser dans le fil de discussion Discourse de la WICM.
- Envoyez un tweet à @ChromiumDev en utilisant le hashtag
#FileHandling
et indiquez-nous où et comment vous l'utilisez.
Liens utiles
- Explication publique
- Démonstration de l'API File Handling | Source de la démonstration de l'API File Handling
- Bug de suivi Chromium
- Enregistrement sur ChromeStatus.com
- Composant clignotement :
UI>Browser>WebAppInstalls>FileHandling
- Récapitulatif du tag
- Position de Mozilla sur les normes
Remerciements
L'API File Handling a été spécifiée par Eric Willigers, Jay Harris et Raymes Khoury. Cet article a été relu par Joe Medley.