Playwright: Simulación de dispositivos y navegadores
Este capítulo explica cómo simular parámetros del entorno del navegador, como dispositivos móviles, geolocalización, zona horaria, idioma y esquema de color en Playwright.
Simulación de dispositivos móviles
Playwright incluye numerosos ajustes preestablecidos de dispositivos que permiten simular el viewport, el User-Agent y el comportamiento táctil de diversos teléfonos y tabletas.
Uso de preajustes de devices
Mediantedevicesel objeto se puede simular rápidamente un dispositivo específico.
Ejemplo
// Simular iPhone 15
const browser = await chromium.launch();
const context = await browser.newContext(devices['iPhone 15']);
const page = await context.newPage();
await page.goto('https://www.example.com/');
// La página se renderizará con el viewport y la UA de iPhone 15
Uso de preajustes de dispositivos en el archivo de configuración:
Ejemplo
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'mobile',
use: { ...devices['Pixel 7'] },
},
],
});
Configuración manual del viewport
Si no necesitas el preajuste completo del dispositivo, también puedes especificar manualmente el tamaño del viewport.
Ejemplo
viewport: { width: 375, height: 812 }, // Tamaño del viewport
deviceScaleFactor: 3, // Relación de píxeles del dispositivo (pantalla Retina)
isMobile: true, // Habilitar el modo móvil
hasTouch: true, // Habilitar la simulación táctil
userAgent: 'Mozilla/5.0 ... Mobile ...', // UA personalizado
});
Simulación de geolocalización
Playwright puede simular la información de ubicación GPS del dispositivo.
Ejemplo
// Otorgar permiso de geolocalización
await context.grantPermissions(['geolocation']);
// Establecer latitud y longitud específicas (coordenadas de Pekín)
await context.setGeolocation({
latitude: 39.9042,
longitude: 116.4074,
});
await page.goto('https://www.example.com/map');
// La página obtendrá la información de ubicación de Pekín
});
Simulación de zona horaria e idioma
Mediante la configuración de locale y timezone se pueden verificar funciones relacionadas con la internacionalización y la zona horaria.
Ejemplo
locale: 'zh-CN', // Establecer el idioma del navegador en chino simplificado
timezone: 'Asia/Shanghai', // Establecer la zona horaria en Shanghái (UTC+8)
});
// Configuración global en el archivo de configuración
export default defineConfig({
use: {
locale: 'en-US',
timezone: 'America/New_York',
},
});
Valores de locale comunes:
| locale | Idioma/Región |
|---|---|
'zh-CN' | Chino simplificado (China) |
'zh-TW' | Chino tradicional (Taiwán) |
'en-US' | Inglés (Estados Unidos) |
'ja-JP' | Japonés |
'ko-KR' | Coreano |
Simulación de esquema de color
Simular el modo claro u oscuro para probarprefers-color-schemeel efecto de las media queries.
Ejemplo
const darkContext = await browser.newContext({
colorScheme: 'dark',
});
// Valores posibles: 'light', 'dark', 'no-preference'
En el archivo de configuración, establece diferentes esquemas de color para diferentes proyectos:
Ejemplo
export default defineConfig({
projects: [
{
name: 'chromium-light',
use: { colorScheme: 'light' },
},
{
name: 'chromium-dark',
use: { colorScheme: 'dark' },
},
],
});
Simulación de permisos
Usarcontext.grantPermissions()para otorgar permisos del navegador.
Ejemplo
'geolocation', // Geolocalización
'notifications', // Notificaciones
'camera', // Cámara
'microphone', // Micrófono
'clipboard-read', // Leer portapapeles
'clipboard-write', // Escribir en el portapapeles
]);
// Limpiar todos los permisos
await context.clearPermissions();
Operaciones con cookies
A través de BrowserContext se pueden leer, agregar y eliminar cookies.
Ejemplo
await context.addCookies([
{
name: 'ejemplo_session',
value: 'session_token_value',
domain: 'www.example.com',
path: '/',
httpOnly: true,
secure: true,
sameSite: 'Lax',
},
]);
// Obtener todas las cookies
const cookies = await context.cookies();
console.log(cookies);
// Obtener cookies de una URL específica
const siteCookies = await context.cookies('https://www.example.com');
// Eliminar todas las cookies
await context.clearCookies();
Descripción de los parámetros de Cookie
| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre de la cookie |
value | string | Valor de la cookie |
domain | string | Dominio de validez |
path | string | Ruta donde tiene efecto, por defecto'/' |
expires | number | Tiempo de expiración (marca de tiempo Unix) |
httpOnly | boolean | Si es accesible solo por HTTP |
secure | boolean | Si se transmite solo por HTTPS |
sameSite | string | Política SameSite:'Strict' | 'Lax' | 'None' |
Operaciones con localStorage y SessionStorage
A través depage.evaluate()se manipula el almacenamiento en el contexto de la página.
Ejemplo
await page.evaluate(() => {
localStorage.setItem('ejemplo_key', 'ejemplo_value');
});
// Leer localStorage
const value = await page.evaluate(() => {
return localStorage.getItem('ejemplo_key');
});
console.log(value); // 'ejemplo_value'
// Limpiar localStorage
await page.evaluate(() => {
localStorage.clear();
});
Otras extensionesLas operaciones de cookies y Storage deben
page.goto()completarse antes de que la página se cargue, asegurando que estos datos estén disponibles.