HTTPPermissions-Policy 标头的bluetooth 指令控制当前文档是否被允许使用Web Bluetooth API。

具体来说，如果定义的策略不允许使用此特性，则由Navigator.bluetooth 返回的Bluetooth 对象的方法将会阻止访问：

• Bluetooth.getAvailability() 将始终以false 的值兑现其返回的Promise。
• Bluetooth.getDevices() 将以SecurityError 类型的DOMException 拒绝其返回的Promise。
• Bluetooth.requestDevice() 将以SecurityError 类型的DOMException 拒绝其返回的Promise。

语法

Permissions-Policy: bluetooth=<allowlist>;

<allowlist>

允许使用该特性的来源列表。请参阅Permissions-Policy > 语法了解更多详细信息。

默认策略

bluetooth 的默认允许列表为：self。

示例

通用示例

SecureCorp Inc. 希望在所有浏览上下文中禁用 Web Bluetooth API，除了其自身的来源和来源https://example.com。它可以通过发送以下 HTTP 响应标头来定义权限策略：

Permissions-Policy: bluetooth=(self "https://example.com")

带有 <iframe> 元素

FastCorp Inc. 希望为除了特定的<iframe> 的所有跨来源的子框架禁用bluetooth。它可以通过发送以下 HTTP 响应标头来定义权限策略：

Permissions-Policy: bluetooth=(self https://other.com/blue)

然后在<iframe> 元素上包含一个allow 属性：

<iframe src="https://other.com/blue" allow="bluetooth"></iframe>

<iframe> 属性可以有选择地在某些框架中启用特性，而在其他框架中禁用这些特性，即使这些框架包含来自同一来源的文档。

规范

浏览器兼容性

参见

• Permissions-Policy 标头
• 权限策略