PermissionStatus: state-Eigenschaft

Baseline 2022

Newly available

Since September 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die state-Eigenschaft des schreibgeschützten PermissionStatus Interfaces gibt den Status einer angeforderten Berechtigung zurück. Diese Eigenschaft gibt einen der folgenden Werte zurück: 'granted', 'denied' oder 'prompt'.

Wert

Einer der folgenden:

'granted'

Der Nutzer oder der Nutzeragent im Namen des Nutzers hat die ausdrückliche Erlaubnis erteilt, ein leistungsstarkes Feature zu verwenden. Der Aufrufer kann das Feature möglicherweise nutzen, ohne dass der Nutzeragent die Erlaubnis des Nutzers einholt.

'denied'

Der Nutzer oder der Nutzeragent im Namen des Nutzers hat den Zugriff auf dieses leistungsstarke Feature verweigert. Der Aufrufer kann das Feature nicht nutzen.

'prompt'

Der Nutzer hat noch keine ausdrückliche Erlaubnis zur Nutzung des Features erteilt (d.h. es entspricht dem Status "verweigert"). Es bedeutet auch, dass der Nutzeragent den Nutzer um Erlaubnis bitten wird, wenn ein Aufrufer versucht, das Feature zu verwenden, oder der Zugriff auf das Feature wird verweigert.

Beispiele

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

Spezifikationen

Specification
Permissions
# dom-permissionstatus-state

Browser-Kompatibilität

BCD tables only load in the browser