Feature-Policy: speaker-selection
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The HTTP Feature-Policy
header speaker-selection
directive controls whether the current document is allowed to enumerate and select audio output devices (speakers, headphones, etc.).
When this policy is enabled and the permission is denied:
MediaDevices.enumerateDevices()
won't return devices of type audio output.MediaDevices.selectAudioOutput()
won't display the popup for selecting an audio output, and will reject the promise with aNotAllowedError
.HTMLMediaElement.setSinkId()
will throw aNotAllowedError
if called for an audio output.
Syntax
Feature-Policy: speaker-selection <allowlist>;
<allowlist>
-
A list of origins for which the feature is allowed. See
Feature-Policy
.
Default policy
The default allowlist for speaker-selection
is 'self'
.
Specifications
Specification |
---|
Audio Output Devices API # permissions-policy-integration |
Browser compatibility
BCD tables only load in the browser