PublicKeyCredential: isConditionalMediationAvailable() statische Methode
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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
| Spezifikation |
|---|
| Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-publickeycredential-isconditionalmediationavailable |