Директива bluetooth заголовка HTTP Permissions-Policy управляет тем, разрешено ли текущему документу использовать Web Bluetooth API.

В частности, если заданная политика запрещает использование этой функции, методы объекта Bluetooth, возвращаемого Navigator.bluetooth, блокируют доступ:

• Bluetooth.getAvailability() всегда будет успешно выполнен с возвращаемым значением Promise, равным false.
• Bluetooth.getDevices() отклонит возвращаемый Promise с ошибкой SecurityError DOMException.
• Bluetooth.requestDevice() отклонит возвращаемый Promise с ошибкой SecurityError DOMException.

Синтаксис

Permissions-Policy: bluetooth=<allowlist>;

<allowlist>

Список источников, которым разрешено использовать эту функцию. Подробнее см. в разделе Permissions-Policy > Синтаксис.

Политика по умолчанию

Список разрешённых источников по умолчанию для bluetooth — self. Контекст просмотра верхнего уровня и iframe с тем же источником по умолчанию имеют доступ к функции bluetooth.

Примеры

Базовое использование

Компания SecureCorp Inc. хочет запретить bluetooth во всех iframe с другим источником, кроме тех, источник которых — https://example.com. Для этого она может отправить следующий заголовок HTTP-ответа, задающий политику разрешений:

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

Компания SecureCorp Inc. также должна добавить атрибут allow к каждому элементу <iframe>, в котором нужно разрешить bluetooth:

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

Использование политики по умолчанию

Если список разрешённых источников для bluetooth не задан в заголовке ответа Permissions-Policy, пользовательские агенты применят список разрешённых источников по умолчанию self. В этом режиме bluetooth автоматически разрешена в контексте просмотра верхнего уровня и iframe с тем же источником, но не в iframe с другим источником.

Чтобы разрешить bluetooth в iframe с другим источником, добавьте атрибут allow к элементу <iframe>:

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

Спецификации

Совместимость с браузерами

См. также

• Заголовок Permissions-Policy
• Политика разрешений