Skip to main content
LoginEmailVerificationMembers description Login Email Verification 画面を操作するために使用できるメンバー (プロパティとメソッド) を定義します。 この画面は email verification プロセスの重要な一部であり、通常はログイン時に、ユーザーがワンタイムコードを入力して メールアドレスの所有者であることを証明する必要があります。SDK は、このコードの送信や 新しいコードのリクエストを可能にします。 この画面の universal_login_context (window.universal_login_context) には、次のものが含まれます:
  • client: Auth0 アプリケーションに関する情報。
  • organization (optional): 認証が特定の organization を対象としている場合の詳細。
  • prompt: 現在の認証 prompt のコンテキスト (例: ‘login’) 。
  • screen: UI テキストと一般的な画面情報。login-email-verification については、標準のものを除き、画面固有の data フィールドは定義されていません。
  • transaction: 進行中のトランザクションの詳細。state や、以前の試行で発生したエラー (例: “invalid-code”) が含まれます。
Example

プロパティ

メソッド

Promise<void>
ユーザーが入力したメール確認コードを送信します。 このアクションは、ユーザーがメールで受け取ったコードを入力し、 “Continue” または “Verify” ボタンをクリックする操作に対応します。SDK はその後、このコードを Auth0 の /u/login-email-verification エンドポイントに POST します。コードが有効な場合、Auth0 は通常、ユーザーを認証フローの次のステップへリダイレクトします。コードが無効、 期限切れ、または別のエラーが発生した場合は、 Auth0 は通常 login-email-verification 画面を再レンダリングし、SDK のコンテキスト内の transaction.errors 配列が失敗の詳細 (例: エラーコード invalid-code) で更新されます。フォーム送信が開始されると解決される Promise です。 通常はリダイレクトまたはページの再レンダリングが発生するため、解決時に 直接データが返されることはありません。

Throws

payload.code が指定されていない場合、または文字列でない場合、 あるいは FormHandler が送信中に回復不能な問題 (例: ネットワークエラー) に遭遇した場合は、エラーをスローします。 Auth0 からのバリデーションエラー (無効なコードなど) は JavaScript エラーとしてはスローされず、 操作後に this.transaction.errors に反映されます。
Example
Promise<void>
ユーザーのメールアドレスに新しい確認コードを送信するようリクエストします。 このアクションは通常、ユーザーが “Resend Code” ボタンをクリックしたときに呼び出されます。たとえば、 最初のメールを受け取っていない場合、コードの有効期限が切れた場合、または問題があると考えられる場合です。 SDK は再送リクエストを示す action とともに、Auth0 の /u/login-email-verification エンドポイントに POST します。このリクエストの送信に成功すると、Auth0 は新しいメールの送信を試みます。 ページが再レンダリングされる場合があります。問題がある場合 (例: 同じメールに対する再送試行回数が多すぎることを示す エラーコード too-many-emails) 、transaction.errors が更新されます。再送リクエストが開始されると解決される Promise です。 continueWithCode と同様、通常は Promise の解決時に直接データが返るのではなく、 ページの再レンダリングまたは state の更新が行われます。

Throws

FormHandler が回復不能な問題 (例: ネットワークエラー) に遭遇した場合はエラーをスローします。 サーバー側のエラー (レート制限など) は this.transaction.errors に反映されます。
Example
この画面の再送機能 (タイムアウト管理付き) を取得します