protocol_handlers

Type Array
Obligatoire Non
Exemple
"protocol_handlers": [
  {
    "protocol": "ircs",
    "name": "IRC Mozilla Extension",
    "uriTemplate": "https://irccloud.mozilla.com/#!/%s"
  }
]

Utilisez cette clé pour enregistrer un ou plusieurs gestionnaires de protocole basés sur le Web.

Un gestionnaire de protocole est une application qui sait comment gérer certains types de liens: par exemple, un client de messagerie est un gestionnaire de protocole pour les liens "mailto:".  Lorsque l'utilisateur clique sur un lien "mailto:", le navigateur ouvre l'application sélectionnée comme le gestionnaire pour le protocole "mailto:" (ou leur offre un choix de gestionnaires, en fonction de leurs paramètres).

Avec cette clé, vous pouvez enregistrer un site Web en tant que gestionnaire pour un protocole particulier. La syntaxe et la sémantique de cette clé ressemblent beaucoup à la fonction Navigator.registerProtocolHandler(), sauf que avec registerProtocolHandler() un site Web ne peut s'inscrire comme un gestionnaire.

Chaque gestionnaire de protocole possède trois propriétés, toutes obligatoires :

protocol
Une chaîne définissant le protocole. Cela doit être soit:
  • L'une des suivantes : "bitcoin", "geo", "im", "irc", "ircs", "magnet", "mailto", "mms", "news", "nntp", "sip", "sms", "smsto", "ssh", "tel", "urn", "webcal", "wtai", "xmpp".
  • Une chaîne composée d'un nom personnalisé préfixé avec "web+" ou "ext+". Par exemple : "web+foo" ou  "ext+foo". Le nom personnalisé doit consister uniquement en caractères ASCII minuscules. Il est recommandé que les extensions utilisent le formulaire "ext+".
name
Une chaîne représentant le nom du gestionnaire de protocole. Cela sera affiché à l'utilisateur lorsqu'ils seront interrogés s'ils souhaitent que ce gestionnaire ouvre le lien.
uriTemplate
Une chaîne représentant l'URL du gestionnaire. Cette chaîne doit inclure "%s" comme espace réservé : cela sera remplacé par l'URL échappée du document à traiter. Cette URL peut être une vraie URL, ou il pourrait s'agir d'un numéro de téléphone, d'une adresse de courrier électronique, etc. Ceci est une propriété localisable.

Exemple

"protocol_handlers": [
  {
    "protocol": "magnet",
    "name": "Magnet Extension",
    "uriTemplate": "https://example.com/#!/%s"
  }
]

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportNoNo5454No

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,