PublicKeyCredential: isUserVerifyingPlatformAuthenticatorAvailable() statische Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die isUserVerifyingPlatformAuthenticatorAvailable()
statische Methode des PublicKeyCredential
-Interfaces gibt ein Promise
zurück, das auf true
aufgelöst wird, wenn ein benutzerverifizierbarer Plattform-Authenticator vorhanden ist.
Ein benutzerverifizierbarer Plattform-Authenticator ist eine Art von Multi-Faktor-Authenticator, der Teil des Client-Geräts ist (er ist in der Regel nicht entfernbar) und eine Handlung des Benutzers erfordert, um ihn zu identifizieren. Gängige benutzerverifizierbare Plattform-Authentikatoren sind:
- Touch ID oder Face ID (macOS und iOS)
- Windows Hello (Windows)
- Geräteentsperrung (Fingerabdruck, Gesicht, PIN usw.) auf Android
Hinweis: Diese Methode kann nur in Top-Level-Kontexten verwendet werden und ist beispielsweise nicht in einem <iframe>
verfügbar.
Syntax
PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()
Parameter
Keine.
Rückgabewert
Ein Promise
, das auf einen booleschen Wert aufgelöst wird, der anzeigt, ob ein benutzerverifizierbarer Plattform-Authenticator verfügbar ist oder nicht.
Hinweis: In früheren Versionen der Spezifikation vermittelte der boolesche Wert auch das Einverständnis des Benutzers, dass ein solcher Authenticator existiert.
Ausnahmen
Das zurückgegebene Promise
kann mit den folgenden Werten abgelehnt werden:
SecurityError
DOMException
-
Die RP-Domain ist ungültig.
Beispiele
PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() .then((available) => { if (available) { // We can proceed with the creation of a PublicKeyCredential // with this authenticator } else { // Use another kind of authenticator or a classical login/password // workflow } }) .catch((err) => { // Something went wrong console.error(err); });
Spezifikationen
Specification |
---|
Web Authentication: An API for accessing Public Key Credentials - Level 3> # dom-publickeycredential-isuserverifyingplatformauthenticatoravailable> |
Browser-Kompatibilität
Loading…