HTTP のPermissions-Policy ヘッダーにおけるbluetooth ディレクティブは、現在の文書でWeb Bluetooth API の使用を許可するかどうかを制御します。

仕様上、ポリシーによってこの機能の使用がブロックされていた場合、Navigator.bluetooth から返されるBluetooth オブジェクトのメソッドのアクセスをブロックします。

• Bluetooth.getAvailability() は常に、返されるプロミス (Promise) をfalse の値で履行します。
• Bluetooth.getDevices() は返されるプロミス (Promise) をSecurityError のDOMException で拒否します。
• Bluetooth.requestDevice() は返されるプロミス (Promise) をSecurityError のDOMException で拒否します。

構文

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)

それからallow 属性を<iframe> 要素に設定します。

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

<iframe> 属性は、特定のフレームで機能を選択的に有効にし、他のフレームでは無効にすることができます。これらのフレームが同じオリジンからの文書を含んでいる場合でも同様です。

仕様書

ブラウザーの互換性

関連情報

• Permissions-Policy ヘッダー
• 権限ポリシー