PublicKeyCredential: isConditionalMediationAvailable() statische Methode
Baseline
2023
Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die isConditionalMediationAvailable() statische Methode der PublicKeyCredential-Schnittstelle gibt ein Promise zurück, das sich auf true auflöst, wenn bedingte Vermittlung verfügbar ist.
Syntax
PublicKeyCredential.isConditionalMediationAvailable()
Parameter
Keine.
Rückgabewert
Ein Promise, das sich auf einen booleschen Wert auflöst und anzeigt, ob die bedingte Vermittlung verfügbar ist oder nicht.
Ausnahmen
Das zurückgegebene Promise kann mit folgenden Werten abgelehnt werden:
SecurityErrorDOMException-
Die RP-Domain ist nicht gültig.
Beispiele
Bevor Sie einen bedingten WebAuthn-API-Aufruf durchführen, überprüfen Sie:
- Ob der Browser die Web Authentication API unterstützt.
- Ob der Browser die bedingte Vermittlung unterstützt.
// 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: challengeFromServer,
// 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",
});
}
}
Spezifikationen
| Specification |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-publickeycredential-isconditionalmediationavailable |