> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.
# MfaWebAuthnRoamingChallenge
```ts Example theme={null}
import MfaWebAuthnRoamingChallenge from "@auth0/auth0-acul-js/mfa-webauthn-roaming-challenge";
const mfaWebAuthnRoamingChallengeManager = new MfaWebAuthnRoamingChallenge();
```
## コンストラクター
新しい `MfaWebAuthnRoamingChallenge` クラスのインスタンスを初期化します。
#### 例外
Universal Login コンテキストを利用できない場合、またはコンテキスト内の画面名が
`MfaWebAuthnRoamingChallenge.screenIdentifier` と一致しない場合に例外がスローされます。
## プロパティ
BrandingMembers} />
ClientMembers} />
OrganizationMembers} />
PromptMembers} />
ScreenMembersOnMfaWebAuthnRoamingChallenge} />
TenantMembers} />
TransactionMembers} />
UntrustedDataMembers} />
UserMembers} />
static
## メソッド
Error[]}>
コンテキストからトランザクションエラーの配列を取得し、存在しない場合は空の配列を返します。
トランザクションコンテキストに含まれるエラーオブジェクトの配列。
特定の WebAuthn API エラーを Auth0 に報告します。
このメソッドは、`navigator.credentials.get()` が
`verify()` では自動的に処理されない形で失敗した場合、または開発者が別のアクションを試す前に明示的に
エラーを報告したい場合に使用します。
このメソッドは、`action: "showError::{errorDetails}"` と共にエラーの詳細を送信します。
エラーレポートが送信されたときに解決される Promise。
#### スロー
フォーム送信に失敗した場合にエラーをスローします。
```typescript Example theme={null}
// 'sdk' が MfaWebAuthnRoamingChallenge のインスタンスであると仮定します
// そして webAuthnError が、失敗した navigator.credentials.get() 呼び出しからのエラーオブジェクトであるとします。
try {
await sdk.reportWebAuthnError({
error: { name: webAuthnError.name, message: webAuthnError.message }
});
} catch (submitError) {
console.error("Failed to report WebAuthn error:", submitError);
}
```
MfaWebAuthnRoamingChallengeReportErrorOptions}>
WebAuthn API からの `name` と `message` を持つ `error` オブジェクトと、
その他の任意のカスタムオプションを含みます。
**プロパティ**
WebAuthnErrorDetails}>
報告対象となる WebAuthn API のエラーオブジェクト。
ユーザーが WebAuthn チャレンジをスキップして、別の MFA メソッドを選択できるようにします。
このアクションは Auth0 に `action: "pick-authenticator"` を送信し、ユーザーを
MFA 要素の選択画面へ遷移させます。
アクションが送信されたときに解決される Promise。
#### スロー
フォーム送信に失敗した場合にエラーをスローします。
```typescript Example theme={null}
// 'sdk' が MfaWebAuthnRoamingChallenge のインスタンスであると仮定します
try {
await sdk.tryAnotherMethod();
// 成功すると、Auth0 が MFA 選択へのリダイレクトを処理します。
} catch (error) {
console.error("Failed to switch MFA method:", error);
}
```
MfaWebAuthnRoamingChallengeTryAnotherMethodOptions}>
リクエスト用の任意のカスタムパラメーター。
`screen.data.publicKeyChallengeOptions` で指定されたオプションを使用して
`navigator.credentials.get()` を呼び出し、WebAuthn チャレンジを開始します。
成功した場合、`action: "default"` と共に取得されたクレデンシャルを Auth0 に送信します。
`navigator.credentials.get()` が既知の WebAuthn API エラー（`NotAllowedError` など）で失敗した場合、
このメソッドは内部的に `reportWebAuthnError` を呼び出して Auth0 に通知します。
検証試行が送信されたときに解決される Promise。
通常、成功時にはリダイレクトが行われるため、データを直接返しません。
#### スロー
`screen.data.publicKeyChallengeOptions` が存在しない場合、
`navigator.credentials.get()` が予期しないエラーで失敗した場合、
または Auth0 へのフォーム送信に失敗した場合にエラーをスローします。
```typescript Example theme={null}
// 'sdk' が MfaWebAuthnRoamingChallenge のインスタンスであると仮定します
try {
await sdk.verify({ rememberDevice: true });
// 成功すると、Auth0 がリダイレクトを処理します。
} catch (error) {
console.error("Security key verification failed:", error);
// ページが再読み込みされた場合は、サーバー側の検証メッセージについて sdk.transaction.errors を確認します。
}
```
VerifySecurityKeyOptions}>
**プロパティ**