Skip to main content
“login-email-verification” 画面での操作を管理します。 この画面では、ログイン処理中に本人確認を行うため、 ユーザーにメールアドレス宛に送信されたワンタイムコードの入力を促します。 入力されたコードを送信するメソッド(continueWithCode)や、 元のコードを受信していない場合や有効期限が切れている場合に新しいコードをリクエストするメソッド(resendCode)を提供します。 BaseContext を継承し、トランザクションの state、クライアント情報、国際化されたテキストなどの 認証フロー間で共有されるデータにアクセスします。
Example

コンストラクター

Constructor
LoginEmailVerification 画面マネージャーのインスタンスを作成します。 このコンストラクターでは BaseContext を初期化します。これは、次の処理を行うことを含みます。

プロパティ

string
Login Email Verification 画面の一意の識別子です。 この静的プロパティは SDK の BaseContext によって使用され、 クラスが正しい画面コンテキストでインスタンス化されることを保証します。

メソッド

Promise<void>
ユーザーが入力したメール認証コードを Auth0 に送信します。 このメソッドは、認証コードを含むフォームデータを準備して送信し、 必須の action: "default" とともに /u/login-email-verification エンドポイントにポストします。フォーム送信が開始されると解決される Promise です。 通常、送信が成功するとサーバー側でリダイレクトが行われます。 コードが誤っている場合やエラーが発生した場合、ページは再レンダーされ、 this.transaction.errors にエラーが格納されます。

Throws

payload.code が存在しないか、文字列ではない場合にスローされます。 送信中に FormHandler で問題が発生した場合(例: ネットワークエラー)にも スローされる可能性があります。Auth0 の検証エラー(例: “invalid-code”)は JS のエラーとしてスローされるのではなく、処理後に this.transaction.errors から参照できるようになります。
Example
コンテキストからトランザクションエラーの配列を取得します。存在しない場合は空の配列を返します。トランザクションコンテキストから取得されるエラーオブジェクトの配列です。
Promise<void>
Auth0 に対して、新しい認証コードをユーザーのメールアドレスに送信するよう要求します。 これは、ユーザーが元のコードを受け取らなかった場合や、有効期限が切れた場合に 一般的に使用されます。このメソッドは、action: "resend-code" を含むフォームデータを /u/login-email-verification エンドポイントにポストします。再送リクエストが開始されると解決される Promise です。 リクエストが成功すると、通常は新しいメールが送信されます。 たとえばレート制限(too-many-emails)に達した場合などは、 ページが再レンダーされ、this.transaction.errors が更新されることがあります。

Throws

FormHandler で問題が発生した場合(例: ネットワークエラー)にスローされます。 サーバー側の検証エラー(例: レート制限)は JS のエラーとしてスローされず、 処理後に this.transaction.errors から参照できるようになります。
Example
Utility Featureこの画面向けの、タイムアウト管理付き再送機能を取得しますstartResend メソッドを持つ ResendControl オブジェクト
Example