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()

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);
  });