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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
isConditionalMediationAvailable() static method

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support