En-tête Refresh
L'en-tête de réponse HTTP Refresh indique à un navigateur web de rafraîchir ou de rediriger la page lorsqu'une durée définie s'est écoulée après le chargement complet de la page.
Il est exactement équivalent à l'utilisation de <meta http-equiv="refresh" content="..."> en HTML.
Note :
Même s'il est présent dans la réponse HTTP, l'en-tête Refresh est toujours géré par le mécanisme de chargement HTML et intervient après les redirections HTTP ou JavaScript. Voir ordre de priorité des redirections pour plus d'informations.
Note :
Lorsqu'un rafraîchissement redirige vers une nouvelle page, l'en-tête Referer est inclus dans la requête pour la nouvelle page (si cela est permis par la Referrer-Policy), et document.referrer est défini sur l'URL de référence après la navigation.
| Type d'en-tête | En-tête de réponse |
|---|
Syntaxe
Refresh: <time>
Refresh: <time>, url=<url>
Refresh: <time>; url=<url>
<time>-
Un nombre de secondes non négatif après lequel la page sera rafraîchie. Les parties fractionnaires sont reconnues mais ignorées ; vous ne devez indiquer que des entiers.
<url>Facultatif-
Si présent, le navigateur redirigera vers l'URL définie au lieu de rafraîchir avec l'URL courante. Cette URL peut être citée ou non. Le préfixe
url=n'est pas sensible à la casse et est optionnel.
Exemples
Rafraîchir une page après un temps spécifique
Cet en-tête fera en sorte que le navigateur rafraîchisse la page 5 secondes après son chargement complet (c'est-à-dire après l'évènement load) :
Refresh: 5
Rediriger après un temps spécifique
Cet en-tête fera en sorte que le navigateur redirige vers une URL 5 secondes après son chargement complet :
Refresh: 5; url=https://exemple.com/
Note :
Voir l'attribut http-equiv="refresh" dans la référence HTML pour des informations importantes sur les implications en accessibilité des redirections automatiques.
Spécifications
| Specification |
|---|
| HTML # the-refresh-header |
Compatibilité des navigateurs
Voir aussi
- L'élément HTML
<meta> - Redirections en HTTP
- L'en-tête Refresh est toujours avec nous (angl.) message du groupe de travail HTTP (2019)