Qualcuno compila un modulo, lo invia, legge la conferma e preme il pulsante Indietro perché è così che le persone tornano a dove erano. Invece del modulo, ricevono una pagina intestata “Confirm Form Resubmission”, con un pulsante che offre di ricaricare, e un tono che suggerisce di aver fatto qualcosa di sbagliato.

Non hanno fatto niente di sbagliato, e nemmeno il browser. Quello che hanno trovato è un divario tra come la tua applicazione ha risposto alla loro richiesta e come il browser è autorizzato a ripeterla.

Vale dieci minuti perché la correzione è tre righe sul server, il sintomo è interamente dalla parte dell’utente, e quasi nessuno che costruisce il modulo vede mai lo schermo.

Il codice sottostante dice qualcosa di diverso

Dietro quella pagina c’è un errore di rete, e non è quello che indovineresti. L’elenco di Chromium dei propri errori di rete lo dà come:

La cache non ha la voce richiesta.

È ERR_CACHE_MISS, numero -400, e la formulazione merita attenzione. Lo schermo parla di moduli. Il codice parla della cache. Nessuno dei due menziona la cosa che è realmente accaduta, che è il browser che gli è stato chiesto di mostrare una pagina che può produrre solo inviando una seconda volta il modulo del tuo utente.

Perché il browser si rifiuta di farlo silenziosamente

Questa è la parte che rende il comportamento corretto anziché fastidioso.

Un invio di modulo è quasi sempre un POST, e il riferimento MDN elenca le tre proprietà che contano qui chiaramente: POST non è sicuro, non è idempotente e è memorizzabile nella cache “solo se sono incluse informazioni di freschezza”.

Non idempotente è quella che decide questo. MDN spiega cosa significa con l’esempio che tutti hanno sperimentato: “Le richieste POST identiche successive possono avere effetti aggiuntivi, come la creazione dello stesso ordine più volte.”

Quindi quando il tuo utente preme indietro, il browser ha una scelta tra non mostrare nulla e piazzare silenziosamente un secondo ordine. Si rifiuta di scegliere per loro e chiede. Detto così, lo schermo che a nessuno piace è il browser che si comporta meglio di quanto ha fatto l’applicazione.

La metà della cache segue dalla stessa lista. Poiché una risposta POST è memorizzabile nella cache solo quando il server lo dice esplicitamente, la pagina a cui il tuo utente sta cercando di tornare quasi certamente non è mai stata archiviata. Non c’è niente a cui tornare. Di qui un cache miss, segnalato nel vocabolario della cache anziché nel vocabolario del modulo.

La correzione è sul server, e è vecchia

Lo schema ha un nome: post, redirect, get. Invece di rispondere a un POST con la pagina che vuoi che l’utente legga, rispondi con un reindirizzamento a una pagina che loro possono fare GET.

La descrizione di MDN di 303 See Other è precisa su quello che ottieni. Il metodo “per recuperare la risorsa reindirizzata è sempre GET”, e lo stato è “spesso inviato come risultato di metodi PUT o POST in modo che il client possa recuperare una conferma”.

Quella ultima clausola è esattamente questa situazione. Il browser dell’utente invia il POST, il tuo server lo elabora e risponde 303 con una Location, il browser recupera quella location con un GET, e la pagina su cui l’utente finisce per guardare è una pagina ordinaria indirizzabile. Premere indietro ora ripete un GET, che il browser può ripetere tutte le volte che vuole, perché un GET non crea ordini.

Rispondere al POST direttamente
La pagina di conferma non ha un indirizzo proprio. Indietro offre di inviare di nuovo, ricaricare si interrompe, e l'URL non può essere condiviso o aggiunto ai preferiti
POST, poi 303, poi GET
La conferma ha un vero URL. Indietro, ricaricare, aggiungere ai preferiti e condividere funzionano tutti, e nulla di quello che l'utente fa può piazzare un secondo ordine

Non 302, e definitivamente non 307

Tre codici di reindirizzamento sembrano intercambiabili qui e non lo sono.

307 Temporary Redirect è, nelle parole di MDN, “un reindirizzamento temporaneo dove il metodo di richiesta non viene modificato”. Dopo un POST è precisamente sbagliato: il browser lo segue inviando il POST di nuovo, a un URL diverso, e hai costruito l’invio duplicato che stavi cercando di prevenire.

302 Found è descritto come “un reindirizzamento temporaneo” senza dire nulla sul metodo, e il suo trattamento da parte dei client reali è stato incoerente abbastanza a lungo che affidarsi ad esso è una scelta piuttosto che un’assunzione.

303 è quello che dichiara la regola ad alta voce. Usalo dopo un modulo.

Perché questo ti arriva come una segnalazione che non puoi riprodurre

Non premi indietro dopo aver inviato un modulo. Invii il modulo, vedi che ha funzionato, e prosegui alla prossima cosa che stavi testando. I tuoi utenti premono indietro costantemente, perché per loro il modulo non è un caso di test, è il mezzo di qualcosa che stavano facendo.

Quindi la segnalazione arriva come una lamentela su uno schermo che non hai mai visto, in parole che non contengono nessuno dei termini che cercheresti. “Ha detto qualcosa sul reinvio.” “Ho premuto indietro e si è rotto.” Nessuno è sbagliato e nessuno ti dice quale modulo, quale pagina, o cosa al browser è stato effettivamente chiesto di fare.

Session Replay

Estensione gratuita per Chrome. Un clic sulla pagina che si comporta male cattura lo screenshot, la console e il registro di rete, e ti restituisce un link da incollare nel ticket.

Installa l'estensione

Le due cose utili da chiedere sono lo schermo stesso e la barra degli indirizzi, perché l’URL è quello che dice se la pagina è stata raggiunta da un GET o è la risposta inindirizzabile a un POST. Una pagina di conferma il cui URL è uguale all’azione del modulo, senza nulla che identifichi la cosa che è stata appena creata, è la forma di questo problema prima che chiunque abbia guardato il server.

Cosa portare via da questo

Un browser che mostra “Confirm Form Resubmission” sta segnalando una decisione architettonica, non un guasto. Da qualche parte un’applicazione ha risposto a un POST con una pagina che si aspettava che le persone restassero, e le persone non restano sulle pagine.

I tre fatti che vale la pena tenere:

  • Il codice sottostante è ERR_CACHE_MISS, che è il motivo per cui cercare il wording dello schermo stesso trova così poco che sia utile.
  • POST non è idempotente, quindi il browser non lo ripeterà senza chiedere, e questo è il comportamento che vuoi.
  • Rispondere a un modulo con 303 e una Location rimuove lo schermo, e fornisce anche alla conferma un URL che può essere ricaricato, aggiunto ai preferiti e condiviso.

L’elenco di Chromium di questi errori, con la definizione di una riga di ciascuno, è net_error_list.h, e è la fonte da cui vengono generate le pagine di errore.