Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

En-tête DPR

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

Attention : L'en-tête DPR a été standardisé sous le nom Sec-CH-DPR et ce nouveau nom est désormais privilégié.

L'en-tête de requête HTTP DPR fournit des indications client pour les appareils concernant le ratio de pixels de l'appareil client (DPR). Ce ratio correspond au nombre de pixels physiques de l'appareil pour chaque pixel CSS.

Cette indication est utile pour sélectionner les sources d'images qui correspondent le mieux à la densité de pixels d'un écran. Cela est similaire au rôle joué par les descripteurs x dans l'attribut srcset de <img>, permettant aux agents utilisateur de sélectionner une image préférée.

Si un serveur utilise l'indication DPR pour choisir la ressource envoyée dans une réponse, la réponse doit inclure l'en-tête Content-DPR. Le client doit utiliser la valeur de Content-DPR pour la mise en page si elle diffère de la valeur de l'en-tête DPR de la requête.

Si l'en-tête DPR apparaît plusieurs fois dans un message, la dernière occurrence est utilisée.

Les serveurs qui activent l'indication client DPR la spécifient généralement aussi dans l'en-tête Vary pour informer les caches que le serveur peut envoyer différentes réponses selon la valeur de l'en-tête dans une requête.

Type d'en-tête En-tête de requête, indication client
En-tête de requête interdit Non

Syntaxe

http
DPR: <number>

Directives

<number>

Le ratio de pixels de l'appareil client.

Exemples

Le serveur doit d'abord activer la réception de l'en-tête DPR en envoyant l'en-tête de réponse Accept-CH contenant la directive DPR :

http
Accept-CH: DPR

Ensuite, lors des requêtes suivantes, le client peut envoyer l'en-tête DPR au serveur :

http
DPR: 2.0

Si une requête avec l'en-tête DPR (comme ci-dessus) concerne une ressource image, alors la réponse du serveur doit inclure l'en-tête Content-DPR :

http
Content-DPR: 2.0

Compatibilité des navigateurs

Voir aussi