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.

Instalar a extensão

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.
  • POST não é idempotente, portanto o navegador não o vai repetir sem perguntar, e esse é o comportamento que quer.
  • Responder a um formulário com 303 e uma Location remove 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.