Skip to main content
ResetPasswordMfaWebAuthnPlatformChallenge
Example
// Assuming 'sdk' is an instance of ResetPasswordMfaWebAuthnPlatformChallenge
try {
  await sdk.continueWithPasskey({
    rememberDevice: true // if user checked the box and sdk.screen.showRememberDevice is true
  });
  // On success, Auth0 handles redirection.
} catch (error) {
  console.error("Platform authenticator verification failed:", error);
  // If it's a WebAuthn API error (DOMException), report it
  if (error instanceof DOMException && error.name && error.message) { // DOMException check
    await sdk.reportBrowserError({ error: { name: error.name, message: error.message } });
  }
  // Check sdk.transaction.errors for server-side validation messages if the page reloads.
}

​
Constructors

​
ResetPasswordMfaWebAuthnPlatformChallenge
Constructor
Initializes a new instance of the ResetPasswordMfaWebAuthnPlatformChallenge class. It retrieves the necessary context (screen, transaction, etc.) from the global universal_login_context and sets up screen-specific properties via ScreenOverride.

​
Throws

If the Universal Login Context is not available or if the screen name in the context does not match ResetPasswordMfaWebAuthnPlatformChallenge.screenIdentifier.

​
Properties

​
branding
​
client
​
organization
​
prompt
​
screen
​
tenant
​
transaction
​
untrustedData
​
user
​
screenIdentifier
string
static

​
Methods

​
continueWithPasskey
Promise<void>
Initiates the WebAuthn platform authenticator challenge by calling navigator.credentials.get() using the challenge options provided in screen.publicKey. If successful, it submits the resulting credential assertion to Auth0 with action: "default".A promise that resolves when the verification attempt is submitted. A successful operation typically results in a redirect.

​
Throws

Throws an error if screen.publicKey is missing, if navigator.credentials.get() fails (e.g., user cancellation NotAllowedError), or if the form submission to Auth0 fails. If navigator.credentials.get() fails with a DOMException, it’s recommended to catch that error and call reportBrowserError.
Example
// Assuming 'sdk' is an instance of ResetPasswordMfaWebAuthnPlatformChallenge
try {
  await sdk.continueWithPasskey({
    rememberDevice: true // if user checked the box and sdk.screen.showRememberDevice is true
  });
  // On success, Auth0 handles redirection.
} catch (error) {
  console.error("Platform authenticator verification failed:", error);
  // If it's a WebAuthn API error (DOMException), report it
  if (error instanceof DOMException && error.name && error.message) { // DOMException check
    await sdk.reportBrowserError({ error: { name: error.name, message: error.message } });
  }
  // Check sdk.transaction.errors for server-side validation messages if the page reloads.
}
​
getErrors
Retrieves the array of transaction errors from the context, or an empty array if none exist.An array of error objects from the transaction context.
​
reportBrowserError
Promise<void>
Reports a browser-side error that occurred during the navigator.credentials.get() API call. This is used to inform Auth0 about issues like user cancellation (NotAllowedError), timeout, or other WebAuthn API specific errors. It submits the error details with action: "showError::{errorDetailsJsonString}".A promise that resolves when the error report is successfully submitted.

​
Throws

If the form submission fails (e.g., network error, invalid state).
Example
// In your UI component, in the catch block of navigator.credentials.get():
// } catch (webAuthnError) {
//   if (webAuthnError instanceof DOMException) {
//     await sdk.reportBrowserError({
//       error: { name: webAuthnError.name, message: webAuthnError.message }
//     });
//   } else {
//     // Handle other types of errors
//   }
// }
​
tryAnotherMethod
Promise<void>
Allows the user to opt-out of the WebAuthn platform authenticator challenge and select a different MFA method for verifying their identity during password reset. This action submits action: "pick-authenticator" to Auth0, which should navigate the user to an MFA factor selection screen.A promise that resolves when the ‘pick-authenticator’ action is submitted.

​
Throws

If the form submission fails (e.g., network error, invalid state).
Example
// In your UI component, when a "Try Another Method" button is clicked:
try {
  await sdk.tryAnotherMethod();
  // On success, Auth0 handles redirection to the MFA factor selection screen.
} catch (error) {
  console.error("Failed to switch MFA method:", error);
}