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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Location

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi