Politique de ratio de pixels de l'appareil avec --bot-dpr

L'échelle d'affichage fait partie de l'identité

window.devicePixelRatio indique à une page combien de pixels physiques se trouvent derrière un pixel CSS. Un portable de bureau renvoie généralement 1 ou 1,25, un MacBook Retina renvoie 2, et de nombreux téléphones renvoient 3. La même valeur alimente les media queries CSS de résolution, la sélection d'images responsives et les calculs de mise en page. Elle accompagne donc le reste de l'identité d'affichage : taille d'écran, taille de fenêtre et profondeur de couleur.

Quand le profil décrit un écran et que le moniteur de l'hôte en est un autre, la session porte deux versions de l'affichage à la fois. BotBrowser 152.0.7977.76 ajoute --bot-dpr pour que ce choix soit explicite, au lieu de dépendre de la machine sur laquelle le navigateur tourne.

Trois modes

Mode	À utiliser quand	Résultat
profile	Le profil doit définir l'identité d'affichage	Utilise l'échelle d'affichage du profil. Par défaut.
real	La session doit suivre l'écran de l'hôte	Utilise l'échelle d'affichage de l'hôte.
advanced	Les échelles de l'hôte et du profil ne peuvent pas être alignées	Utilise un mode de compatibilité pour ce flux de travail.

profile est la valeur par défaut, donc les lancements existants conservent leur comportement actuel. Choisissez un autre mode uniquement si le déploiement l'exige.

Lancement

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-dpr=profile

Passez à real lorsque l'écran de l'hôte est l'environnement voulu, par exemple une session avec interface sur un poste de travail qui représente le propre moniteur de l'opérateur :

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-dpr=real

advanced est un mode de compatibilité, pas un mode plus précis. Il conserve l'échelle du profil avec un ajustement limité de la mise en page, sans remettre toute la page à l'échelle. Préférez profile pour les sessions basées sur un profil et real lorsque l'écran de l'hôte est voulu. N'utilisez advanced que si aucun des deux ne convient, et gardez le profil, la version du navigateur et la configuration de lancement fixes pendant l'évaluation.

Associer le DPR à la fenêtre et à l'écran

DPR, fenêtre et écran forment une seule configuration d'affichage. Modifiez-les ensemble, pas un par un d'une exécution à l'autre.

chromium-browser \
  --bot-profile="/path/to/profile.enc" \
  --bot-dpr=profile \
  --bot-window=profile \
  --bot-screen=profile

Les sessions de bureau avec interface utilisent par défaut les dimensions de fenêtre et d'écran de l'hôte. Si une session avec interface doit exposer les dimensions du profil, définissez --bot-window=profile et --bot-screen=profile à côté de --bot-dpr=profile. Le guide écran et fenêtre couvre les flags de taille, et l'émulation d'appareils couvre les profils mobiles.

Sessions par contexte

Avec les empreintes par contexte, définissez --bot-dpr avant que le BrowserContext ne crée sa première page ou son premier worker. La politique reste attachée au comportement d'affichage et de mise en page de ce contexte pendant toute sa durée de vie.

const { browserContextId } = await client.send('Target.createBrowserContext', {
  botbrowserFlags: [
    '--bot-profile=/path/to/profile.enc',
    '--bot-dpr=profile'
  ]
});

Utilisez le même mode pour le navigateur principal et un profil par contexte lorsqu'ils représentent le même appareil. Choisissez un mode différent uniquement si le contexte représente volontairement un autre environnement d'affichage. Mettre à l'échelle les contextes de navigateur couvre le cycle de vie des contextes plus largement.

Valider

1. Démarrez une session avec le profil choisi et un seul mode DPR.
2. Gardez la fenêtre, l'écran et le DPR inchangés pendant toute la vérification.
3. Démarrez une seconde session avec le même profil et le même mode, et confirmez que le comportement d'affichage est identique.
4. Pour comparer des modes, changez uniquement --bot-dpr et notez la commande de lancement complète de chaque exécution.

Vérifier l'empreinte de votre navigateur liste des outils de vérification publics qui affichent les valeurs d'affichage exposées.

Dépannage

Situation	Action
Comportement d'affichage du profil attendu	--bot-dpr=profile
La session doit suivre l'écran de l'hôte	--bot-dpr=real
Les échelles de l'hôte et du profil ne peuvent pas être alignées	--bot-dpr=advanced
L'affichage diffère entre les contextes	Définir le mode avant que chaque contexte ne crée des pages ou des workers
Les dimensions avec interface suivent l'hôte	Ajouter --bot-window=profile et --bot-screen=profile

L'entrée complète du flag se trouve dans la référence des flags CLI.