Back to Content

Navigator: permissions property

files/en-us/web/api/navigator/permissions/index.md

latest793 B
Original Source

{{APIRef("Permissions API")}}

The permissions read-only property of the {{domxref("Navigator")}} interface returns a {{domxref("Permissions")}} object that can be used to query and update permission status of APIs covered by the Permissions API.

Value

A {{domxref("Permissions")}} object.

Examples

js
navigator.permissions.query({ name: "geolocation" }).then((result) => {
  if (result.state === "granted") {
    showMap();
  } else if (result.state === "prompt") {
    showButtonToEnableMap();
  }
  // Don't do anything if the permission was denied.
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also