A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from http://developer.mozilla.org/zh-CN/docs/Web/API/Navigator/registerProtocolHandler below:

Navigator：registerProtocolHandler() 方法 - Web API

Navigator：registerProtocolHandler() 方法

Limited availability

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

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

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

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

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

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

语法 
registerProtocolHandler(scheme, url)
参数
scheme

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

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

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

url

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

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

返回值

无（undefined）。

异常
SecurityError DOMException

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

SyntaxError DOMException

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

示例 为 mailto 协议注册处理器

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

<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",
);

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

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

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

规范 浏览器兼容性

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4