Navigator：registerProtocolHandler() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

Navigator 的 registerProtocolHandler() 方法让 web 站点为自身注册用于打开或处理特定 URL 方案（又名协议）的能力。

举个例子，此 API 允许 Web 邮件站点打开 mailto: URL，或让 VoIP 站点打开 tel: URL。

要注册协议处理器，网站在调用 registerProtocolHandler() 时传入要注册的协议和模板 URL。

在用户激活使用来注册的协议的链接时，浏览器会将激活链接的 href 插入到处理器注册时提供的 URL 模板中，并将当前页面导航到生成的 URL。

浏览器可能会要求用户确认是否允许页面处理该协议，无论是在注册协议时还是在用户激活链接时。

registerProtocolHandler(scheme, url)

一个包含站点希望处理的协议的方案字符串。

其可能是一个自定义方案，此时方案的名称：

否则，方案必须是以下值之一：

一个包含处理器 URL 的字符串。该 URL 必须包含 %s（作为占位符），其会被将要处理且经过转义的 URL 所替换。

处理器 URL 必须使用 https 方案，并且必须与尝试注册处理器的网页具有相同的来源。

无（undefined）。

用户代理阻止了注册。这可能是由于：

处理器 URL 中缺失占位符 %s。

网页使用非 https 协议来链接资源是非常常见的。例如，mailto: 协议。当 Web 作者想要为用户提供一个直接通过网页发送电子邮件的便捷方式时，可以使用 mailto 链接：

html

<a href="mailto:webmaster@example.com">Web 管理员</a>

当链接被激活时，浏览器应该启动默认的桌面应用程序来处理电子邮件。你可以认为这是一个基于桌面平台协议处理器。

基于 Web 的协议处理器允许基于 Web 的应用程序参与这一过程。例如，mail.example.org 上的电子邮件 Web 应用程序可以使用以下代码注册来处理 mailto 链接：

navigator.registerProtocolHandler("mailto", "https://mail.example.org/?to=%s");

此后，当用户点击网站上的 mailto 链接时，浏览器将（可能要求浏览器进行确认）导航到 https://mail.example.org/?to=mailto:webmaster@example.com。此页面可以解析 URL 参数来提取地址，并使用此地址来初始化电子邮件。

在这个示例中，页面使用以下代码来注册 web+burger 协议的处理器：

navigator.registerProtocolHandler(
  "web+burger",
  "https://burgers.example.org/?burger=%s",
);

随后，用户访问包含如下链接的页面：

html

<a href="web+burger:cheeseburger">芝士汉堡</a>

如果用户激活了 web+burger 链接，浏览器将（可能要求浏览器进行确认）导航到 https://burgers.example.org/?burger=web+burger:cheeseburger。

Specification
HTML Standard # custom-handlers

BCD tables only load in the browser