Permissions-Policy: bluetooth
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
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> 属性は、特定のフレームで機能を選択的に有効にし、他のフレームでは無効にすることができます。これらのフレームが同じオリジンからの文書を含んでいる場合でも同様です。
仕様書
| Specification |
|---|
| Web Bluetooth # permissions-policy |
ブラウザーの互換性
Loading…
関連情報
Permissions-Policyヘッダー- 権限ポリシー