PermissionStatus

The PermissionStatus interface of the Permissions API provides the state of an object and an event handler for monitoring changes to said state.

Instance properties

PermissionStatus.name Read only: Returns the name of a requested permission, identical to the name passed to Permissions.query.
PermissionStatus.state Read only: Returns the state of a requested permission; one of 'granted', 'denied', or 'prompt'.
PermissionStatus.status Read only Deprecated: Returns the state of a requested permission; one of 'granted', 'denied', or 'prompt'. Later versions of the specification replace this with PermissionStatus.state.

Events

change: An event called whenever PermissionStatus.status changes.

Example

navigator.permissions
  .query({ name: "geolocation" })
  .then((permissionStatus) => {
    console.log(`geolocation permission status is ${permissionStatus.state}`);
    permissionStatus.onchange = () => {
      console.log(
        `geolocation permission status has changed to ${permissionStatus.state}`
      );
    };
  });

Specifications

Specification
Permissions # permissionstatus-interface

Browser compatibility

BCD tables only load in the browser