Protocol Handlers
Utilities to work with protocol handlers on the web.
Why?
While the Navigator API provides methods to .registerProtocolHandler() and .unregisterProtocolHandler(), there's no way to check if a given protocol has a handler. Instead, when trying to open a URL with an unsupported protocol the browser will throw an error that you cannot handle by any normal means (can be handled only in Firefox).
This package fills in the gap and provides API to work with protocol handlers.
Install
npm install protocol-handlers
API
openUrl
Returns a promise that resolves if the given URL has successfuly opened (has a registered handler for its protocol) or rejects if it doesn't have a registered handler.
import { openUrl, UnsupportedProtocolError } from 'protocol-handlers'
// For example, try to open a Visual Studio Code Insiders URI.
// If that application is not installed, handle the rejection.
openUrl('vscode-insiders://resource').catch((error) => {
if (error instanceof UnsupportedProtocolError) {
console.log('The "%s" protocol is not supported!', error.protocol)
}
})
Options
timeout: number
A custom timeout duration.
openUrl('my-app://resource', {
// Wait for 2s for the navigation modal to appear
// before rejecting this Promise.
timeout: 2000,
})
9 Sep 17, 2022
6 Nov 20, 2022
5 Sep 8, 2022
16 Aug 30, 2022
16 Jun 23, 2022
11 Nov 1, 2022
128 Dec 21, 2022
35 Dec 19, 2022
1 Jul 11, 2022