Navigator: registerProtocolHandler() 方法

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

Navigator 接口的 registerProtocolHandler() 方法允许网站注册它们处理特定 URL 方案（也称为协议）的能力，以打开或响应这些链接。

例如，此 API 允许网页邮件站点处理 mailto: URL，或 VoIP 站点处理 tel: URL。

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

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

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

语法

registerProtocolHandler(scheme, url)

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

这可能是一个自定义方案，在这种情况下，方案名称

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

一个包含处理程序 URL 的字符串。此 URL 必须包含 %s，它将作为占位符，替换为要处理的经过转义的 URL。

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

无（undefined）。

SecurityError DOMException

用户代理阻止了注册。这可能发生在以下情况：

处理程序的 URL 中缺少 %s 占位符。

网页通过非 https 协议链接到资源的场景很常见。一个例子是 mailto: 协议。当网页作者希望为用户提供一种方便的方式直接从网页发送电子邮件时，他们可以使用 mailto 链接。

html

<a href="mailto:webmaster@example.com">Web Master</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">cheeseburger</a>

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

规范
HTML # custom-handlers

此页面最后修改于 ⁨2025年6月23日⁩，由 MDN contributors 修改。