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

import { chromium, devices } from 'playwright';

// 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

// Ruta del archivo: playwright.config.ts
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

const context = await browser.newContext({
  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

test('Simular la ubicación de Pekín', async ({ context, page }) => {
  // 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

const context = await browser.newContext({
  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:

localeIdioma/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

// Probar el modo oscuro
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

// Ruta del archivo: playwright.config.ts
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

await context.grantPermissions([
  '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

// Agregar cookie
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

CampoTipoDescripción
namestringNombre de la cookie
valuestringValor de la cookie
domainstringDominio de validez
pathstringRuta donde tiene efecto, por defecto'/'
expiresnumberTiempo de expiración (marca de tiempo Unix)
httpOnlybooleanSi es accesible solo por HTTP
securebooleanSi se transmite solo por HTTPS
sameSitestringPolí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

// Establecer localStorage
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();
});

Las operaciones de cookies y Storage debenpage.goto()completarse antes de que la página se cargue, asegurando que estos datos estén disponibles.

Otras extensiones