Location

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 de navegadores

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
LocationChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support

Veja também