大网数据广告活动
Web 标准与前端开发

Permissions-Policy: bluetooth

· 52CE 我爱测

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

HTTP Permissions-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>;

默认策略

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> 元素上包含一个 iframe 属性:

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

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。