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
awaitplacé 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.
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.