
Alguém preenche um formulário, envia-o, lê a confirmação, e pressiona o botão voltar porque é assim que as pessoas regressam ao sítio onde estavam. Em vez do formulário, recebem uma página com o cabeçalho “Confirmar Reenvio de Formulário”, com um botão a oferecer para recarregar e um tom que sugere que fizeram algo errado.
Não fizeram nada errado, e nem o navegador. O que encontraram é uma lacuna entre a forma como a sua aplicação respondeu ao seu pedido e a forma como o navegador pode repeti-lo.
Vale a pena dez minutos porque a correção tem apenas três linhas no servidor, o sintoma está inteiramente no lado do utilizador, e quase ninguém que cria o formulário vê alguma vez o ecrã.
O código subjacente diz algo diferente
Por trás dessa página há um erro de rede, e não é o que adivinharia. A própria lista de erros de rede do Chromium descreve-o como:
A cache não tem a entrada solicitada.
Esse é o ERR_CACHE_MISS, número -400, e as palavras merecem atenção. O ecrã fala sobre
formulários. O código fala sobre a cache. Nenhum deles menciona a coisa que realmente aconteceu,
que é o navegador ter sido pedido para mostrar uma página que só consegue produzir enviando o
formulário do seu utilizador uma segunda vez.
Por que é que o navegador se recusa a fazer isso silenciosamente
Esta é a parte que torna o comportamento correto em vez de chato.
Um envio de formulário é quase sempre um POST, e a referência da MDN lista claramente as três
propriedades que importam aqui: POST não é seguro, não é idempotente, e é cacheável
“apenas se forem incluídas informações de atualização”.
Não idempotente é o que decide isto. A MDN explica o que significa com o exemplo que toda a
gente já viveu: “Pedidos sucessivos idênticos de POST podem ter efeitos adicionais, como criar
a mesma encomenda várias vezes.”
Então quando o seu utilizador pressiona voltar, o navegador tem uma escolha entre não mostrar nada e silenciosamente colocar uma segunda encomenda. Recusa-se a escolher em seu nome e pergunta. Colocado assim, o ecrã que ninguém gosta é o navegador a comportar-se melhor do que a aplicação fez.
A metade da cache segue da mesma lista. Como uma resposta POST é cacheável apenas quando o
servidor o diz explicitamente, a página para a qual o seu utilizador está a tentar regressar
quase certamente nunca foi armazenada. Não há nada para onde voltar. Daí um cache miss, reportado
no vocabulário da cache em vez do vocabulário do formulário.
A correção está no servidor, e é antiga
O padrão tem um nome: post, redirect, get. Em vez de responder a um POST com a página que
deseja que o utilizador leia, responda com um reencaminhamento para uma página que ele pode fazer
GET.
A descrição da MDN de 303 See Other é precisa sobre o que isto lhe ganha. O método “para
obter o recurso reencaminhado é sempre GET”, e o estado é “frequentemente enviado como
resultado de métodos PUT ou POST para que o cliente possa obter uma confirmação”.
Essa última cláusula é esta situação exata. O navegador do utilizador envia o POST, o seu
servidor processa-o e responde com 303 e uma Location, o navegador obtém essa localização
com um GET, e a página na qual o utilizador acaba por olhar é uma página endereçável comum.
Pressionar voltar agora executa novamente um GET, que o navegador pode repetir quantas vezes
quiser, porque um GET não cria encomendas.
- Responder diretamente ao POST
- A página de confirmação não tem endereço próprio. Voltar oferece reenviar, recarregar quebra-se, e o URL não pode ser partilhado ou marcado
- POST, depois 303, depois GET
- A confirmação tem um URL real. Voltar, recarregar, marcador e partilha funcionam todos, e nada que o utilizador faça pode colocar uma segunda encomenda
Não 302, e definitivamente não 307
Três códigos de reencaminhamento parecem intercambiáveis aqui e não são.
307 Temporary Redirect é, em palavras da MDN, “um reencaminhamento temporário onde o método de
pedido não é modificado”. Após um POST isso é precisamente errado: o navegador segue-o enviando
o POST novamente, para um URL diferente, e construiu o envio duplicado que estava a tentar
evitar.
302 Found é descrito como “um reencaminhamento temporário” sem nada dito sobre o método, e o seu
tratamento por clientes reais tem sido inconsistente o suficiente para que confiar nele seja uma
escolha em vez de uma suposição.
303 é o que declara a regra em voz alta. Use-o após um formulário.
Por que isto a si chega como um relatório que não consegue reproduzir
O utilizador não pressiona voltar após enviar um formulário. Você envia o formulário, vê que funcionou, e passa para a coisa seguinte que estava a testar. Os seus utilizadores pressionam voltar constantemente, porque para eles o formulário não é um caso de teste, é o meio de algo que estavam a fazer.
Então o relatório chega como uma reclamação sobre um ecrã que nunca viu, em palavras que não contêm nenhum dos termos pelos quais procuraria. “Disse algo sobre reenvio.” “Pressionei voltar e rebentou.” Nenhum está errado e nenhum diz qual formulário, qual página, ou o que o navegador foi realmente pedido para fazer.
Session Replay
Extensão gratuita do Chrome. Um clique na página que se está a portar mal captura a captura de ecrã, a consola e o registo de rede, e devolve-lhe um link para colar no ticket.
As duas coisas úteis para pedir são o ecrã e a barra de endereços, porque o URL é o que diz se a
página foi alcançada por um GET ou é a resposta indisponível a um POST. Uma página de
confirmação cujo URL é o mesmo que a ação do formulário, sem nada identificando a coisa que foi
apenas criada, é a forma deste problema antes de alguém ter olhado para o servidor.
O que tirar daqui
Um navegador mostrando “Confirmar Reenvio de Formulário” está a reportar uma decisão
arquitetónica, não uma falha. Em algum lado uma aplicação respondeu a um POST com uma página
na qual esperava que as pessoas ficassem, e as pessoas não ficam em páginas.
Os três factos que vale a pena manter:
- O código subjacente é
ERR_CACHE_MISS, o que é porquê a procura pela própria redação do ecrã encontra tão pouco que é útil. -
POSTnão é idempotente, portanto o navegador não o vai repetir sem perguntar, e esse é o comportamento que quer. - Responder a um formulário com
303e umaLocationremove o ecrã, e também dá à confirmação um URL que pode ser recarregado, marcado e partilhado.
A lista de erros do Chromium, com a definição de uma linha de cada, é net_error_list.h, e é a fonte a partir da qual as páginas de erro são geradas.