Quelqu’un remplit un formulaire, l’envoie, lit la confirmation, et presse le bouton retour parce que c’est ainsi que les gens reviennent d’où ils venaient. Au lieu du formulaire, ils obtiennent une page intitulée « Confirmer la resoumission de formulaire », avec un bouton offrant de recharger et un ton qui suggère qu’ils ont fait quelque chose de mal.

Ils n’ont rien fait de mal, et le navigateur non plus. Ce qu’ils ont trouvé est un écart entre la façon dont votre application a répondu à leur requête et comment le navigateur est autorisé à la répéter.

Cela vaut dix minutes parce que la correction ne prend que trois lignes sur le serveur, le symptôme est entièrement du côté de l’utilisateur, et presque personne qui construit le formulaire ne voit jamais cet écran.

Le code sous-jacent dit quelque chose de différent

Derrière cette page se cache une erreur réseau, et ce n’est pas celle que vous devineriez. La propre liste des erreurs réseau de Chromium la donne comme :

Le cache ne contient pas l’entrée demandée.

C’est ERR_CACHE_MISS, numéro -400, et la formulation mérite attention. L’écran parle de formulaires. Le code parle du cache. Aucun d’eux ne mentionne ce qui s’est réellement passé, à savoir que le navigateur a été invité à afficher une page qu’il ne peut produire qu’en envoyant une deuxième fois le formulaire de votre utilisateur.

Pourquoi le navigateur refuse de le faire silencieusement

C’est la partie qui rend le comportement correct plutôt qu’ennuyeux.

L’envoi d’un formulaire est presque toujours un POST, et la référence de MDN énumère clairement les trois propriétés qui importent ici : POST est non sécurisé, non idempotent, et cacheable « seulement si les informations d’actualisation sont incluses ».

Non idempotent est celui qui décide. MDN expose ce que cela signifie avec l’exemple que tout le monde a vécu : « Les demandes POST successives identiques peuvent avoir des effets supplémentaires, comme créer la même commande plusieurs fois. »

Donc quand votre utilisateur appuie sur retour, le navigateur a le choix entre ne rien afficher et passer silencieusement une deuxième commande. Il refuse de choisir en leur nom et demande. Présenté ainsi, l’écran que personne n’aime est le navigateur se comportant mieux que l’application ne l’a fait.

La moitié du cache suit de la même liste. Comme une réponse POST n’est cacheable que lorsque le serveur le dit explicitement, la page à laquelle votre utilisateur essaie de revenir n’a presque certainement jamais été stockée. Il n’y a rien à quoi revenir. D’où une défaillance du cache, rapportée en utilisant le vocabulaire du cache plutôt que celui du formulaire.

Le correctif est sur le serveur, et il est ancien

Le modèle a un nom : post, redirect, get. Plutôt que de répondre à un POST par la page que vous voulez que l’utilisateur lise, répondez par une redirection vers une page qu’il peut GET.

La description de 303 See Other dans MDN est précise sur ce que cela vous apporte. La méthode « pour récupérer la ressource redirigée est toujours GET », et le statut est « souvent renvoyé en tant que résultat des méthodes PUT ou POST pour que le client puisse récupérer une confirmation ».

Cette dernière clause est exactement cette situation. Le navigateur de l’utilisateur envoie le POST, votre serveur le traite et répond 303 avec une Location, le navigateur récupère cette adresse avec un GET, et la page que l’utilisateur regarde est une page ordinaire adressable. Appuyer sur retour réexécute maintenant un GET, que le navigateur peut répéter autant de fois qu’il le souhaite, parce qu’un GET ne crée pas de commandes.

Répondre directement au POST
La page de confirmation n'a pas d'adresse propre. Retour offre de renvoyer, recharger échoue, et l'URL ne peut pas être partagée ou marquée
POST, puis 303, puis GET
La confirmation a une vraie URL. Retour, recharger, marquer et partager fonctionnent tous, et rien de ce que l'utilisateur fait ne peut placer une deuxième commande

Pas 302, et certainement pas 307

Trois codes de redirection semblent interchangeables ici et ne le sont pas.

307 Temporary Redirect est, selon MDN, « une redirection temporaire où la méthode de requête n’est pas modifiée ». Après un POST c’est précisément faux : le navigateur le suit en envoyant le POST à nouveau, vers une URL différente, et vous avez créé l’envoi en doublon que vous tentiez d’empêcher.

302 Found est décrit comme « une redirection temporaire » sans rien de dit sur la méthode, et son traitement par les clients réels a été assez incohérent pour que s’y fier soit un choix plutôt qu’une hypothèse.

303 est celui qui énonce la règle à haute voix. Utilisez-le après un formulaire.

Pourquoi cela vous atteint sous forme de rapport que vous ne pouvez pas reproduire

Vous n’appuyez pas sur retour après avoir soumis un formulaire. Vous soumettez le formulaire, constatez que cela a fonctionné, et passez à la chose suivante que vous testiez. Vos utilisateurs appuient sur retour constamment, parce que pour eux le formulaire n’est pas un cas de test, c’est le milieu de quelque chose qu’ils faisaient.

Le rapport arrive donc comme une plainte concernant un écran que vous n’avez jamais vu, en des termes qui ne contiennent aucun des mots que vous rechercheriez. « Il disait quelque chose sur la resoumission. » « J’ai appuyé sur retour et cela s’est cassé. » Ni l’un ni l’autre n’est faux et aucun ne vous dit quel formulaire, quelle page, ou ce qu’on a réellement demandé au navigateur de faire.

Session Replay

Extension Chrome gratuite. Un clic sur la page qui se comporte mal capture la capture d'écran, la console et le journal réseau, et vous remet un lien à coller dans le ticket.

Installer l'extension

Les deux choses utiles à demander sont l’écran lui-même et la barre d’adresse, car l’URL est ce qui dit si la page a été atteinte par un GET ou est la réponse non affichable à un POST. Une page de confirmation dont l’URL est la même que l’action du formulaire, sans rien identifiant la chose qui vient d’être créée, est la forme de ce problème avant que quiconque ne regarde le serveur.

Ce qu’il faut en retenir

Un navigateur affichant « Confirmer la resoumission de formulaire » rapporte une décision architecturale, pas une défaillance. Quelque part, une application a répondu à un POST par une page qu’elle s’attendait à ce que les gens restent, et les gens ne restent pas sur les pages.

Les trois faits à retenir :

  • Le code sous-jacent est ERR_CACHE_MISS, ce qui explique pourquoi rechercher la formulation de l’écran lui-même trouve si peu de choses utiles.
  • POST n’est pas idempotent, donc le navigateur ne le repassera pas sans demander, et c’est le comportement que vous voulez.
  • Répondre à un formulaire avec 303 et une Location supprime l’écran, et cela donne aussi à la confirmation une URL qui peut être rechargée, marquée et partagée.

La liste de Chromium de ces erreurs, avec la définition d’une ligne pour chacune, est net_error_list.h, et c’est la source à partir de laquelle les pages d’erreur sont générées.