PublicKeyCredential: isConditionalMediationAvailable() statische Methode

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die statische Methode isConditionalMediationAvailable() der PublicKeyCredential-Schnittstelle gibt ein Promise zurück, das sich auf true auflöst, wenn bedingte Mediation verfügbar ist.

Syntax

js
PublicKeyCredential.isConditionalMediationAvailable()

Parameter

Keine.

Rückgabewert

Ein Promise, das sich zu einem booleschen Wert auflöst, der angibt, ob die bedingte Mediation verfügbar ist oder nicht.

Beispiele

Bevor Sie einen bedingten WebAuthn-API-Aufruf ausführen, sollten Sie prüfen, ob:

  • Der Browser die Web Authentication API unterstützt.
  • Der Browser die bedingte WebAuthn-UI unterstützt.
js
// Availability of `window.PublicKeyCredential` means WebAuthn is usable.
if (
  window.PublicKeyCredential &&
  PublicKeyCredential.isConditionalMediationAvailable
) {
  // Check if conditional mediation is available.
  const isCMA = await PublicKeyCredential.isConditionalMediationAvailable();
  if (isCMA) {
    // Call WebAuthn authentication
    const publicKeyCredentialRequestOptions = {
      // Server generated challenge
      challenge: ****,
      // The same RP ID as used during registration
      rpId: "example.com",
    };

    const credential = await navigator.credentials.get({
      publicKey: publicKeyCredentialRequestOptions,
      signal: abortController.signal,
      // Specify 'conditional' to activate conditional UI
      mediation: "conditional",
    });
  }
}

Hinweis: Weitere Informationen zur Verwendung der bedingten Mediation finden Sie unter Anmelden mit einem Passkey über das automatische Ausfüllen von Formularen.

Spezifikationen

Specification
Web Authentication: An API for accessing Public Key Credentials - Level 3
# dom-publickeycredential-isconditionalmediationavailable

Browser-Kompatibilität

BCD tables only load in the browser