useResend

useResend(options?) · UseResendReturn

Ce hook React gère les actions de « renvoi » (p. ex., renvoyer un code de vérification) dans les écrans ACUL.

Ce hook :

• Suit le délai d’attente restant.
• Indique si le bouton de renvoi doit être désactivé.
• Fournit une fonction startResend pour déclencher un renvoi immédiatement.

​

Paramètres

options · UseResendOptions

Configuration facultative, comme timeoutSeconds et onTimeout.

​

Valeur de retour

UseResendReturn

Un objet avec :

• remaining — nombre de secondes restantes avant que le prochain renvoi soit autorisé.
• disabled — true si le renvoi est actuellement bloqué.
• startResend — fonction pour lancer un renvoi immédiatement (si autorisé).

​

Écrans pris en charge

• email-identifier-challenge
• email-otp-challenge
• login-email-verification
• login-passwordless-email-code
• login-passwordless-sms-otp
• mfa-email-challenge
• mfa-sms-challenge
• mfa-voice-challenge
• phone-identifier-challenge
• reset-password-mfa-email-challenge
• reset-password-mfa-sms-challenge
• reset-password-mfa-voice-challenge

Example

import { useResend } from '@auth0/auth0-acul-react/mfa-sms-challenge';

export function ResendButton() {
  const { remaining, disabled, startResend } = useResend({
    timeoutSeconds: 30,
    onTimeout: () => console.log('You can resend again'),
  });

  return (
    <button onClick={startResend} disabled={disabled}>
      {disabled ? `Resend in ${remaining}s` : 'Resend Code'}
    </button>
  );
}

​

Remarques

• Le ResendControl sous-jacent n’a pas de méthode de nettoyage explicite; le hook ne nécessite aucun nettoyage manuel.
• Le hook réinitialise le gestionnaire de renvoi si timeoutSeconds ou onTimeout changent.