Autorisez les PWA installées à gérer les liens qui utilisent un protocole spécifique pour une expérience plus intégrée.
Informations sur les schémas (ou protocoles)
Un URI (Uniform Resource Identifier) est une séquence compacte de caractères qui identifie une ressource abstraite ou physique. Chaque URI commence par un nom de schéma qui fait référence à une spécification permettant d'attribuer des identifiants dans ce schéma. La syntaxe d'URI est donc un système de dénomination fédéré et extensible dans lequel la spécification de chaque schéma peut restreindre davantage la syntaxe et la sémantique des identifiants utilisant ce schéma. Les schémas sont également appelés "protocoles". Voici quelques exemples de schémas.
tel:+1-816-555-1212
mailto:Jane.Doe@example.com
news:comp.infosystems.www.servers.unix
https://web.dev/
Le terme Uniform Resource Locator (URL) fait référence au sous-ensemble d'URI qui, en plus d'identifier une ressource, fournissent un moyen de la localiser en décrivant son mécanisme d'accès principal (par exemple, son emplacement réseau).
Contexte de la méthode registerProtocolHandler()
La méthode Navigator (contenu sécurisé uniquement) registerProtocolHandler() permet aux sites d'enregistrer leur capacité à ouvrir ou à gérer des schémas d'URL particuliers. Par conséquent, les sites doivent appeler la méthode comme suit : navigator.registerProtocolHandler(scheme, url). Les deux paramètres sont définis comme suit :
scheme: chaîne contenant le protocole que le site souhaite gérer.url: chaîne contenant l'URL du gestionnaire. Cette URL doit inclure%s, qui sert d'espace réservé et sera remplacé par l'URL échappée à gérer.
Le schéma doit être l'un des schémas de la liste d'autorisation (par exemple, mailto, bitcoin ou magnet) ou commencer par web+, suivi d'au moins une lettre ASCII minuscule après le préfixe web+, par exemple web+coffee.
Pour que tout soit bien clair, voici un exemple concret de ce flux :
- L'utilisateur consulte un site à l'adresse
https://coffeeshop.example.com/qui effectue l'appel suivant :navigator.registerProtocolHandler('web+coffee', 'coffee?type=%s'). - Plus tard, lorsqu'il consulte
https://randomsite.example.com/, l'utilisateur clique sur un lien tel que<a href="web+coffee:latte-macchiato">All about latte macchiato</a>. - Le navigateur accède alors à l'URL suivante :
https://coffeeshop.example.com/coffee?type=web%2Bcoffee%3A%2F%2Flatte-macchiato. La chaîne de recherche décodée par l'URL indique alors?type=web+coffee://latte-macchiato.
En quoi consiste la gestion des protocoles ?
Le mécanisme actuel d'enregistrement du gestionnaire de protocoles d'URL pour les PWA consiste à proposer l'enregistrement du gestionnaire de protocoles dans le cadre de l'installation d'une PWA via son fichier manifeste. Après avoir enregistré une PWA en tant que gestionnaire de protocole, lorsqu'un utilisateur clique sur un lien hypertexte avec un schéma spécifique tel que mailto, bitcoin ou web+music depuis un navigateur ou une application spécifique à une plate-forme, la PWA enregistrée s'ouvre et reçoit l'URL. Il est important de noter que l'enregistrement proposé basé sur un fichier manifeste et l'enregistrement registerProtocolHandler() traditionnel jouent des rôles très similaires en pratique, tout en permettant des expériences utilisateur complémentaires :
- Les similitudes incluent les exigences concernant la liste des schémas autorisés à être enregistrés, ainsi que le nom et le format des paramètres, entre autres.
- Les différences dans l'enregistrement basé sur le fichier manifeste sont subtiles, mais peuvent être utiles pour améliorer l'expérience des utilisateurs de PWA. Par exemple, l'enregistrement d'une PWA basé sur un fichier manifeste peut ne pas nécessiter d'action supplémentaire de la part de l'utilisateur, en dehors de l'installation de la PWA initiée par l'utilisateur.
Cas d'utilisation
- Dans une PWA de traitement de texte, l'utilisateur d'un document rencontre un lien vers une présentation comme
web+presentations://deck2378465. Lorsque l'utilisateur clique sur le lien, la PWA de présentation s'ouvre automatiquement dans le bon champ d'application et affiche la présentation. - Dans une application de chat spécifique à une plate-forme, l'utilisateur reçoit un lien vers une URL
magnetdans un message de chat. Lorsque l'utilisateur clique sur le lien, une PWA torrent installée se lance et commence le téléchargement. - L'utilisateur a installé une PWA de streaming musical. Lorsqu'un ami partage un lien vers un titre comme
web+music://songid=1234&time=0:13et que l'utilisateur clique dessus, la PWA de streaming musical se lance automatiquement dans une fenêtre autonome.
Utiliser l'enregistrement du gestionnaire de protocoles d'URL pour les PWA
L'API d'enregistrement du gestionnaire de protocoles d'URL est calquée sur navigator.registerProtocolHandler(). Cette fois, les informations sont transmises de manière déclarative à l'aide du fichier manifeste de l'application Web dans une nouvelle propriété appelée "protocol_handlers", qui accepte un tableau d'objets avec les deux clés requises "protocol" et "url". L'extrait de code suivant montre comment enregistrer web+tea et web+coffee. Les valeurs sont des chaînes contenant l'URL du gestionnaire avec l'espace réservé %s requis pour l'URL échappée.
{
"protocol_handlers": [
{
"protocol": "web+tea",
"url": "/tea?type=%s"
},
{
"protocol";: "web+coffee",
"url": "/coffee?type=%s"
}
]
}
Plusieurs applications s'enregistrant pour le même protocole
Si plusieurs applications s'enregistrent en tant que gestionnaires pour le même schéma, par exemple le protocole mailto, le système d'exploitation affiche un sélecteur permettant à l'utilisateur de choisir le gestionnaire enregistré à utiliser.
La même application s'enregistre pour plusieurs protocoles
La même application peut s'enregistrer pour plusieurs protocoles, comme vous pouvez le voir dans l'exemple de code.
Mises à jour d'application et enregistrement du gestionnaire
Les enregistrements de gestionnaires sont synchronisés avec la dernière version du fichier manifeste fournie par l'application. Il existe deux cas de figure :
- Une mise à jour qui ajoute de nouveaux gestionnaires déclenche l'enregistrement des gestionnaires (séparément de l'installation de l'application).
- Une mise à jour qui supprime des gestionnaires déclenche l'annulation de l'enregistrement des gestionnaires (distincte de la désinstallation de l'application).
Débogage du gestionnaire de protocoles dans les Outils de développement
Accédez à la section Protocol Handlers (Gestionnaires de protocoles) à l'aide du volet Application > Manifest (Fichier manifeste). Vous pouvez afficher et tester tous les protocoles disponibles ici.
Considérations de sécurité
Étant donné que l'installation d'une PWA nécessite un contexte sécurisé, la gestion des protocoles hérite de cette contrainte. La liste des gestionnaires de protocoles enregistrés n'est pas exposée sur le Web. Elle ne peut donc pas être utilisée comme vecteur d'empreinte numérique.
Tentatives de navigation non initiées par l'utilisateur
Les tentatives de navigation qui ne sont pas initiées par l'utilisateur, mais qui sont programmatiques, peuvent ne pas ouvrir d'applications. L'URL du protocole personnalisé ne peut être utilisée que dans des contextes de navigation de premier niveau, mais pas, par exemple, comme URL d'un iFrame.
Liste d'autorisation des protocoles
Comme pour registerProtocolHandler(), il existe une liste d'autorisation des protocoles que les applications peuvent enregistrer pour les gérer.
Invite de consentement
Lors du premier lancement de la PWA en raison d'un protocole appelé, une boîte de dialogue d'autorisation s'affiche. Cette boîte de dialogue affiche le nom et l'origine de l'application, et demande à l'utilisateur si l'application est autorisée à gérer les liens du protocole. Si un utilisateur refuse la boîte de dialogue d'autorisation, le gestionnaire de protocole enregistré sera ignoré par le système d'exploitation. Pour annuler l'enregistrement du gestionnaire de protocole, l'utilisateur doit désinstaller la PWA qui l'a enregistré. Le navigateur désenregistrera également le gestionnaire de protocole si l'utilisateur sélectionne "Mémoriser mon choix" et "Interdire".
Commentaires
L'équipe Chromium souhaite connaître votre avis sur l'enregistrement du gestionnaire de protocoles d'URL pour les PWA.
Parlez-nous de la conception de l'API
Y a-t-il quelque chose dans l'API qui ne fonctionne 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 trouvé un bug dans l'implémentation de Chromium ? Ou l'implémentation est-elle différente de la spécification ?
Signalez un bug sur new.crbug.com. Veillez à inclure autant de détails que possible, ainsi que des instructions pour reproduire le problème, et saisissez UI>Browser>WebAppInstalls dans le champ Components (Composants).
Afficher la compatibilité avec l'API
Prévoyez-vous d'utiliser l'enregistrement du gestionnaire de protocoles d'URL pour les PWA ? Votre soutien public aide l'équipe Chromium à prioriser les fonctionnalités et montre aux autres fournisseurs de navigateurs l'importance de les prendre en charge.
Expliquez comment vous comptez l'utiliser sur le fil de discussion Discourse du WICG. Envoyez un tweet à @ChromiumDev avec le hashtag #ProtocolHandler pour nous indiquer où et comment vous l'utilisez.
Liens utiles
Remerciements
L'enregistrement du gestionnaire de protocoles d'URL pour les PWA a été implémenté et spécifié par Fabio Rocha, Diego González, Connor Moody et Samuel Tang de l'équipe Microsoft Edge. Ce document a été examiné par Joe Medley et Fabio Rocha.