Skip to content

Detect whether a custom protocol is available in browser (FF, Chrome, IE8, IE9, IE10, IE11, and Edge)

License

Notifications You must be signed in to change notification settings

nm777/custom-protocol-detection

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Custom Protocol Detection in Browser

Detect whether a custom protocol is available in browser (FF, Chrome, IE8, IE9, IE10, IE11, and Edge)

The implementation is different from one browser to another, sometimes depend on which OS you are. Most of them are hacks, meaning that the solution is not the prettiest.

  • Firefox: try to open the handler in a hidden iframe and catch exception if the custom protocol is not available.
  • Chrome: using window onBlur to detect whether the focus is stolen from the browser. When the focus is stolen, it assumes that the custom protocol launches external app and therefore it exists.
  • IEs and Edge in Win 8/Win 10: the cleanest solution. IEs and Edge in Windows 8 and Windows 10 does provide an API to check the existence of custom protocol handlers.
  • Other IEs: various different implementation. Worth to notice that even the same IE version might have a different behavior (I suspect due to different commit number). It means that for these IEs, the implementation is the least reliable.

Note:

In addition to providing callback functions for failure, success, and unsupported browsers, you may also provide an optional timeouts argument that controls how long the browser waits for timeout-based checks (currently Chrome, IOS, legacy IE, and Safari use timeouts). The timeouts argument is an object in the following format:

{
    chromeAndIOS: <intTimeoutInMs>,
    legacyIE:     <intTimeoutInMs>,
    safari:       <intTimeoutInMs>
}

Known Issues

  • In some protocol such as "mailto:", IE seems to trigger the fail callback while continuing on opening the protocol just fine (tested in IE11/Win 10). This issue doesn't occur with a custom protocol.
  • Edge, in contrast, never fail anything as it will just offer users to find an app in Windows Store to open an unknown protocol.

About

Detect whether a custom protocol is available in browser (FF, Chrome, IE8, IE9, IE10, IE11, and Edge)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 96.6%
  • HTML 3.4%