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.

L'en-tête de réponse Location indique l'URL vers laquelle rediriger une page. Il a un sens seulement lorsqu'il est servi avec une réponse d'état 3xx (redirection) ou 201 (créé).

En cas de redirection, la méthode HTTP utilisée pour la nouvelle requête de récupération de la page pointée par Location dépend la méthode d'origine et du type de redirection :

  • Si les réponses 303 (Voir Aussi) conduisent toujours à l'utilisation d'une méthode GET, 307 (Redirection Temporaire) et 308 (Redirection Permanente) ne modifient pas la méthode utilisée dans la demande d'origine;
  • 301 (Redirection permanente) et 302 (Trouvé) ne change pas la méthode la plupart du temps, bien que les user-agents plus anciens puissent.

Toutes les réponses avec l'un de ces codes d'état envoient un en-tête Location.

En cas de création de ressource, il indique l'URL de la ressource nouvellement créée.

Location et Content-Location sont différents : Location indique la cible d'une redirection (ou l'URL d'une ressource nouvellement créée), tandis que Content-Location indique l'URL directe à utiliser pour accéder à la ressource lorsque la négociation de contenu a eu lieu, sans qu'il soit nécessaire de poursuivre la négociation de contenu. L'emplacement est un en-tête associé à la réponse, tandis que Content-Location est associé à l'entité renvoyée.

Type d'en-tête Response header
Forbidden header name non

Syntaxe

Location: <url>

Directives

<url>

Une URL relative (à l'URL de la demande) ou absolue.

Exemples

Location: /index.html

Spécifications

Specification
HTTP Semantics
# field.location

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi