En-tête Refresh
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
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
| Spécification |
|---|
| 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)