Firefox Tomorrow

web api interface

PermissionStatus

View on MDN ↗

Available in workers

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

  • name Read only
    • : Returns the name of a requested permission, identical to the name passed to query.
  • state Read only
    • : Returns the state of a requested permission; one of 'granted', 'denied', or 'prompt'.

Events

  • change
    • : Invoked upon changes to PermissionStatus.state.

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

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.