useMfaPolling

• チャレンジがユーザーによって承認または拒否されると、options.onCompleted が呼び出されます。
• エラー（ネットワークエラー、200/429 以外のレスポンス）が発生すると、options.onError が呼び出されます。
• コンポーネントがアンマウントされるか stopPolling() が呼び出されると、ポーリングがキャンセルされます。

​

主な機能

• isRunning はリアクティブに変化します — ポーリングループが内部的に停止した場合やキャンセルされた場合、自動的に更新されます。
• React の再レンダー中に重複したネットワーク呼び出しや意図しない再起動を防ぐために、 安定した単一のポーリングインスタンス（useRef）を使用します。
• アンマウント時に自動的にクリーンアップされます：孤立したタイマーやリークした XHR リクエストは発生しません。

​

パラメータ

​

戻り値

• isRunning — ポーリングがアクティブな間は true。
• startPolling() — ポーリングを開始または再開します。
• stopPolling() — 直ちにポーリングを停止します。

​

対応している画面

• mfa-push-challenge-push
• reset-password-mfa-push-challenge-push
• mfa-push-enrollment-qr

import { useMfaPolling } from '@auth0/auth0-acul-react/mfa-push-challenge-push';

export function MfaPushStatus() {
  const { isRunning, startPolling, stopPolling } = useMfaPolling({
    intervalMs: 5000,
    onCompleted: () => console.log('Push approved!/denied'),
    onError: (error) => console.error('Polling error:', error)
  });

  return (
    <div>
      <button onClick={startPolling} disabled={isRunning}>
        {isRunning ? 'Waiting for approval…' : 'Start MFA Polling'}
      </button>
      {isRunning && <button onClick={stopPolling}>Cancel</button>}
    </div>
  );
}

​

備考

• onError コールバックは、サーバーレスポンスを説明する status と responseText を含む ULError オブジェクトを受け取ります。
• 内部のレート制限レスポンス（429）は自動的に処理されます。 ポーリングはリセットウィンドウまで待機してから再試行します。
• 実行中に startPolling() を繰り返し呼び出しても安全であり、その動作は冪等です。