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.


Permissions-Policy: battery=<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.


Battery Status API
# permissions-policy-integration

Browser compatibility

BCD tables only load in the browser

See also