Location

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

O cabeçalho de resposta Location indica o URL para qual página deve-se ser redirecionada. Ele só tem significado quando é enviado junto a uma resposta de status 3xx (redirecionamento) ou 201 (criado).

Em casos de redirecionamento, o método HTTP utilizado para fazer a nova requisição à página apontada pelo cabeçalho Location depende do método original e do tipo de redirecionamento:

  • Se respostas com status 303 (Veja também) sempre levam ao uso do método GET, 307 (Redirecionamento Temporário) e 308 (Redirecionamento Permanente) não mudam o método utilizado na requisição original;
  • 301 (Movido Permanentemente) e 302 (Encontrado) não mudam o método na maior parte das vezes, entretanto agentes de usuário antigos talvez mudem (basicamente você não sabe se eles farão isso).

Todas as respostas com um desses códigos de status enviam um cabeçalho Location.

Em casos de recursos de criação, ele indica o URL para o novo recurso criado.

Location e Content-Location são diferentes: Location indica o alvo de redirecionamento (ou URL do novo recurso criado), enquanto Content-Location indica o URL direto para ter acesso ao recurso quando negociação de conteúdo acontecer, sem a necessidade de futura negociação de conteúdo. Location é um cabeçalho associado com a resposta, enquanto Content-Location é associado com a entidade retornada.

Tipo de cabeçalho Response header
Forbidden header name não

Sintaxe

Location: <url>

Diretivas

<url>

Uma URL relativa (ao URL de requisição) ou absoluta.

Exemplos

Location: /index.html

Especificações

Especificação Título
RFC 7231, sessão 7.1.2: Location Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também