PublicKeyCredential: isConditionalMediationAvailable() statische Methode

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

Wenn die bedingte Vermittlung verfügbar ist, werden alle entdeckten Anmeldedaten dem Benutzer in einem nicht-modalen Dialogfeld zusammen mit einem Hinweis auf den Ursprung, der die Anmeldedaten anfordert, präsentiert. Dies wird angefordert, indem mediation: 'conditional' in Ihrem get()-Aufruf enthalten ist. In der Praxis bedeutet dies das automatische Ausfüllen verfügbarer Anmeldedaten; Sie müssen autocomplete="webauthn" in Ihren Formularfeldern einschließen, damit die WebAuthn-Anmeldeoptionen angezeigt werden.

Ein bedingter get()-Aufruf zeigt nicht die Browser-Benutzeroberfläche und bleibt ausstehend, bis der Benutzer ein Konto aus den verfügbaren automatischen Ausfüllvorschlägen auswählt, um sich anzumelden:

• Wenn der Benutzer eine Aktion außerhalb des Dialogs durchführt, schließt sich dieser, ohne das Promise aufzulösen oder abzulehnen, und ohne eine für den Benutzer sichtbare Fehlersituation zu verursachen.
• Wenn der Benutzer ein Anmeldedatum auswählt, wird dieses dem Aufrufer zurückgegeben.

Das Flag zur Verhinderung des stillen Zugriffs (siehe CredentialsContainer.preventSilentAccess()) wird unabhängig von seinem tatsächlichen Wert als true behandelt: Das bedingte Verhalten beinhaltet immer eine Benutzervermittlung irgendeiner Art, wenn anwendbare Anmeldedaten entdeckt werden.

isConditionalMediationAvailable()

// 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",
    });
  }
}