Permissions-Policy: battery

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The HTTP Permissions-Policy header battery directive controls whether the current document is allowed to gather information about the battery of the device through the BatteryManager interface obtained via Navigator.getBattery().

Specifically, where a defined policy blocks use of this feature, getBattery() calls will return a Promise that rejects with a DOMException of type NotAllowedError.

Syntax

http
Permissions-Policy: battery=<allowlist>;
<allowlist>

A list of origins for which permission is granted to use the feature. See Permissions-Policy > Syntax for more details.

Default policy

The default allowlist for battery is self.

Specifications

Specification
Battery Status API
# permissions-policy-integration

Browser compatibility

BCD tables only load in the browser

See also