Política de relación de píxeles del dispositivo con --bot-dpr

La escala de pantalla forma parte de la identidad

window.devicePixelRatio indica a una página cuántos píxeles físicos hay detrás de un píxel CSS. Un portátil de oficina suele informar 1 o 1.25, un MacBook Retina informa 2 y muchos teléfonos informan 3. El mismo valor alimenta las media queries de resolución CSS, la selección de imágenes responsivas y los cálculos de diseño, así que viaja junto con el resto de la identidad de pantalla: tamaño de pantalla, tamaño de ventana y profundidad de color.

Cuando el perfil describe una pantalla y el monitor del host es otro, la sesión transmite dos versiones distintas de la pantalla al mismo tiempo. BotBrowser 152.0.7977.76 añade --bot-dpr para que la elección sea explícita en lugar de depender de la máquina en la que se ejecuta el navegador.

Tres modos

Modo	Cuándo usarlo	Resultado
profile	El perfil debe definir la identidad de pantalla	Usa la escala de pantalla del perfil. Predeterminado.
real	La sesión debe seguir la pantalla del host	Usa la escala de pantalla del host.
advanced	La escala del host y la del perfil no se pueden alinear	Usa una alternativa de compatibilidad para ese flujo.

profile es el valor predeterminado, así que los lanzamientos existentes mantienen su comportamiento actual. Configura otro modo solo cuando el despliegue lo necesite.

Lanzamiento

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

Cambia a real cuando la pantalla del host sea el entorno previsto, por ejemplo una sesión con interfaz gráfica en una estación de trabajo que representa el propio monitor del operador:

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

advanced es una alternativa de compatibilidad, no un modo de mayor precisión. Mantiene la escala del perfil con ajustes de diseño limitados en lugar de reescalar toda la página. Prefiere profile para sesiones basadas en perfil y real cuando la pantalla del host sea intencionada. Usa advanced solo cuando ninguno de los dos encaje, y mantén fijos el perfil, la versión del navegador y la configuración de lanzamiento mientras lo evalúas.

Combínalo con ventana y pantalla

DPR, ventana y pantalla forman una sola configuración de pantalla. Cámbialos juntos, no uno por uno entre ejecuciones.

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

Las sesiones de escritorio con interfaz gráfica usan por defecto las dimensiones de ventana y pantalla del host. Si una sesión con interfaz gráfica debe informar las dimensiones del perfil, configura --bot-window=profile y --bot-screen=profile junto a --bot-dpr=profile. La guía de pantalla y ventana cubre los flags de tamaño, y la emulación de dispositivos cubre los perfiles móviles.

Sesiones por contexto

Con huellas digitales por contexto, configura --bot-dpr antes de que el BrowserContext cree su primera página o worker. La política queda asociada al comportamiento de pantalla y diseño de ese contexto durante toda su vida.

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

Usa el mismo modo para el navegador principal y para un perfil por contexto cuando representan el mismo dispositivo. Elige un modo distinto solo cuando el contexto represente de forma deliberada otro entorno de pantalla. Escalar contextos de navegador cubre el ciclo de vida de los contextos en general.

Validación

1. Inicia una sesión con el perfil elegido y un único modo DPR.
2. Mantén ventana, pantalla y DPR sin cambios durante toda la comprobación.
3. Inicia una segunda sesión con el mismo perfil y el mismo modo y confirma que el comportamiento de pantalla coincide.
4. Al comparar modos, cambia solo --bot-dpr y registra el comando de lanzamiento completo de cada ejecución.

Verifica la huella digital de tu navegador enumera verificadores públicos que muestran los valores de pantalla informados.

Solución de problemas

Situación	Acción
Se espera el comportamiento de pantalla del perfil	--bot-dpr=profile
La sesión debe seguir la pantalla del host	--bot-dpr=real
La escala del host y la del perfil no se pueden alinear	--bot-dpr=advanced
La pantalla difiere entre contextos	Configura el modo antes de que cada contexto cree páginas o workers
Las dimensiones con interfaz gráfica siguen al host	Añade --bot-window=profile y --bot-screen=profile

La entrada completa del flag está en la referencia de flags CLI.