protocol_handlers

Protocol handlers objects may contain the following values:

protocol Experimental

A required string containing the protocol to be handled; e.g.: mailto, ms-word, web+jngl.

url Experimental

Required HTTPS URL within the application scope that will handle the protocol. The %s token will be replaced by the URL starting with the protocol handler's scheme. If url is a relative URL, the base URL will be the URL of the manifest.

In this example, a web app manifest declares that the app should be registered to handle the protocols web+jngl and web+jnglstore.

"protocol_handlers": [
  {
    "protocol": "web+jngl",
    "url": "/https/developer.mozilla.org/lookup?type=%s"
  },
  {
    "protocol": "web+jnglstore",
    "url": "/https/developer.mozilla.org/shop?for=%s"
  }
]

A developer can add a field in the manifest.json to declare which protocols the web app can handle. As seen in the example above, the key is named protocol_handlers and it contains an array of protocol handler declaration objects.

Registering applications to handle URL schemes is operating-system dependent. This association is usually done during application install but it can also be done afterwards from an app that has already been installed.