PermissionStatus: state-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2022 browserübergreifend verfügbar.
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
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
| Spezifikation |
|---|
| Permissions # dom-permissionstatus-state |