Código de status HTTP · Sucesso (2xx)
205 Reset Content
O 205 Reset Content significa que o pedido deu certo e o cliente deve redefinir a tela que o enviou, por exemplo limpar um formulário para o usuário digitar o próximo registro. Assim como o 204, não tem corpo, mas os navegadores não limpam o formulário de forma confiável, então quase só aparece em clientes próprios.
| Classe | 2xx, Sucesso |
|---|---|
| Definido em | RFC 9110 §15.3.6 |
| Pode ir para o cache por padrão | Só com Cache-Control ou Expires explícitos |
| Pode repetir o pedido | Não é preciso; o pedido deu certo |
| Cabeçalhos relevantes | Nenhum específico deste código |
O que significa o 205
A RFC 9110, seção 15.3.6, descreve um ciclo de digitação: o usuário preenche um formulário, bloco de notas ou canvas, envia, e a área de entrada volta ao estado inicial para o próximo registro. O servidor NÃO PODE enviar conteúdo num 205.
Como o comportamento dos navegadores varia, trate o 205 como um sinal para o seu próprio JavaScript: if (res.status === 205) form.reset().
Quando usar
- Telas de digitação repetitiva (contagem de estoque, totens de pesquisa, anotações de caixa) cujo código cliente limpa o formulário ao receber 205.
Como enviar um 205
app.post('/entries', (req, res) => {
res.status(205).end();
});// app/entries/route.ts
export async function POST() {
return new Response(null, { status: 205 });
}mux.HandleFunc("POST /entries", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusResetContent) // 205
})from fastapi import FastAPI, Response
app = FastAPI()
@app.post("/entries")
def add_entry():
return Response(status_code=205)Costuma ser confundido com
- 205 vs 204
- O 204 diz "pronto, mantenha a página como está"; o 205 diz "pronto, agora limpe os campos para a próxima entrada".
- 205 vs 200
- Um 200 pode devolver dados, como o registro salvo; um 205 não pode trazer nenhum.
Perguntas frequentes
- O navegador limpa o formulário quando recebe 205?
- Não de forma confiável. Os navegadores costumam tratar como 204 e ficam na página. Limpe o formulário no seu próprio código quando o fetch() devolver 205.
- Uma resposta 205 pode ter corpo?
- Não. A RFC 9110 diz que o servidor NÃO PODE gerar conteúdo numa resposta 205, então envie sem corpo nenhum.
- Quando usar 205 em vez de 204?
- Quando você controla o cliente e quer que o servidor decida que a tela de entrada deve ser limpa depois de um envio bem-sucedido. Fora disso, o 204 é a opção mais conhecida.
Revisado em por Arielton Oberek.