Formations — 1 037 leçons en français

Accueil › React › Soumettre sans double envoi

Soumettre sans double envoi

Les formulairesdebutant

Le traitement se branche sur le <form>, pas sur le bouton : onSubmit attrape aussi la touche Entrée.

const [envoiEnCours, setEnvoiEnCours] = useState(false);
const [erreurServeur, setErreurServeur] = useState(null);

async function soumettre(e) {
  e.preventDefault();
  if (envoiEnCours) return;                 // verrou, avant tout await

  const erreurs = valider(valeurs);
  if (Object.keys(erreurs).length > 0) {
    setVisites(tousVisites(valeurs));       // montrer toutes les erreurs
    return;
  }

  setEnvoiEnCours(true);
  setErreurServeur(null);
  try {
    const r = await fetch("/api/inscriptions", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(valeurs),
    });
    if (!r.ok) throw new Error("HTTP " + r.status);
    setValeurs(VIDE);
  } catch {
    setErreurServeur("L'envoi a échoué. Réessayez dans un instant.");
  } finally {
    setEnvoiEnCours(false);                 // quoi qu'il arrive
  }
}
<button type="submit" disabled={envoiEnCours}>
  {envoiEnCours ? "Envoi…" : "S'inscrire"}
</button>
{erreurServeur && <p role="alert">{erreurServeur}</p>}

Trois points font la différence. Le verrou est posé avant le premier await : tout await placé plus haut rend la main au navigateur, qui traite alors le second clic sur un verrou encore libre. Le bouton est désactivé pendant l'envoi, ce qui donne à l'utilisateur l'information qui lui manque. Et le finally réactive tout, succès comme échec — sans lui, une requête qui échoue laisse le formulaire bloqué pour de bon.

L'erreur de serveur occupe un état à part : elle ne désigne aucun champ à corriger, donc elle ne peut pas s'afficher sous l'un d'eux.

Les termes à connaître

`onSubmit`

L'événement du <form>, déclenché par le bouton d'envoi et par la touche Entrée dans un champ. C'est le seul endroit correct pour traiter une soumission.

`preventDefault`

Empêche le comportement par défaut du navigateur — ici, recharger la page en envoyant le formulaire en HTTP. Appelé en toute première ligne du gestionnaire.

État d'envoi

Un booléen qui dit qu'une requête est en cours. Il désactive le bouton, change son libellé, et sert de verrou.

Verrou

Le test qui refuse une seconde soumission tant que la première n'est pas finie. Il doit être posé avant le premier await.

Fenêtre de double envoi

L'intervalle entre le clic et la pose du verrou. Tout await placé avant le verrou rend la main au navigateur, et un second clic y passe.

`finally`

Le bloc exécuté quoi qu'il arrive, succès comme échec. C'est là qu'on relâche le verrou, jamais dans le seul chemin de succès.

Erreur de serveur

Un échec global — réseau coupé, 500, session expirée — affiché à part des erreurs de champ, car il ne désigne aucun champ à corriger.

Idempotence

La propriété d'une opération qu'on peut rejouer sans effet supplémentaire. Côté serveur, une clé d'idempotence est la vraie protection contre le double envoi.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.