window.navigator.registerProtocolHandler

Résumé

Permet aux sites web de s'enregistrer en tant que gestionnaires possibles pour des protocoles particuliers.

null

Syntaxe

window.navigator.registerProtocolHandler(protocole,uri,titre);
  • protocole est le protocole que le site désire gérer, sous la forme d'une chaîne.
  • uri est l'URI du gestionnaire sous la forme d'une chaîne. Il peut contenir « %s » pour indiquer où insérer l'URI échappée du document à gérer, comme montré dans l'exemple plus bas.
  • titre est le titre du gestionnaire présenté à l'utilisateur, sous la forme d'une chaîne.

Exemple

Si votre application web est située à http://www.example.com, vous pouvez enregistrer un gestionnaire de protocole lui permettant de gérer « mailto » comme ceci :

navigator.registerProtocolHandler("mailto",
                                 "https://www.example.com/?to=%s",
                                 "Example Mail");

Ceci crée un gestionnaire permettant aux liens mailto de diriger l'utilisateur vers l'application web, en insérant l'adresse spécifiée dans le lien dans l'URL.

Spécification

Spécifié dans le brouillon de travail Web Applications 1.0 du WHATWG.

Voir également