Back to Content

PermissionStatus: name property

files/en-us/web/api/permissionstatus/name/index.md

latest923 B
Original Source

{{APIRef("Permissions API")}}{{AvailableInWorkers}}

The name read-only property of the {{domxref("PermissionStatus")}} interface returns the name of a requested permission.

Value

A read-only value that is identical to the name argument passed to {{domxref("Permissions.query", "navigator.permissions.query()")}}.

Examples

js
function stateChangeListener() {
  console.log(`${this.name} permission status changed to ${this.state}`);
}
function queryAndTrackPermission(permissionName) {
  navigator.permissions
    .query({ name: permissionName })
    .then((permissionStatus) => {
      console.log(
        `${permissionName} permission state is ${permissionStatus.state}`,
      );
      permissionStatus.onchange = stateChangeListener;
    });
}
queryAndTrackPermission("geolocation");
queryAndTrackPermission("midi");

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}