Эмуляция устройств и браузеров Playwright

В этой главе рассказывается, как имитировать параметры среды браузера, такие как мобильные устройства, геолокация, часовой пояс, язык и цветовая схема, в Playwright.


Эмуляция мобильных устройств

Playwright имеет множество встроенных предустановок устройств, которые позволяют имитировать область просмотра, User-Agent и сенсорное поведение различных телефонов и планшетов.

Использование предустановки devices

Используяdevicesобъект, вы можете быстро имитировать конкретное устройство.

Пример

import { chromium, devices } from 'playwright';

// Имитировать 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/');
// Страница будет отображаться с областью просмотра и UA iPhone 15

Использование предустановок устройств в файле конфигурации:

Пример

// Путь к файлу: playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [
    {
      name: 'mobile',
      use: { ...devices['Pixel 7'] },
    },
  ],
});

Ручная настройка области просмотра

Если вам не нужна полная предустановка устройства, вы можете вручную указать размер области просмотра.

Пример

const context = await browser.newContext({
  viewport: { width: 375, height: 812 },     // Размер области просмотра
  deviceScaleFactor: 3,                       // Соотношение пикселей устройства (экран Retina)
  isMobile: true,                             // Включить мобильный режим
  hasTouch: true,                             // Включить эмуляцию касаний
  userAgent: 'Mozilla/5.0 ... Mobile ...',    // Пользовательский UA
});

Эмуляция геолокации

Playwright может имитировать информацию о GPS-местоположении устройства.

Пример

test('Симулировать местоположение Пекина', async ({ context, page }) => {
  // Предоставить разрешение на геолокацию
  await context.grantPermissions(['geolocation']);

  // Задать конкретные широту и долготу (координаты Пекина)
  await context.setGeolocation({
    latitude: 39.9042,
    longitude: 116.4074,
  });

  await page.goto('https://www.example.com/map');
  // Страница получит информацию о местоположении Пекина
});

Эмуляция часового пояса и языка

Проверьте интернационализацию и функциональность, связанную с часовым поясом, установив локаль и часовой пояс.

Пример

const context = await browser.newContext({
  locale: 'zh-CN',                // Установить язык браузера на упрощенный китайский
  timezone: 'Asia/Shanghai',      // Установить часовой пояс на Шанхай (UTC+8)
});

// Задать глобально в файле конфигурации
export default defineConfig({
  использовать: {
    locale: 'en-US',
    timezone: 'America/New_York',
  },
});

Общие значения локали:

локальЯзык/Регион
'zh-CN'Упрощённый китайский (Китай)
'zh-TW'Традиционный китайский (Тайвань)
'en-US'Английский (США)
'ja-JP'Японская
'ko-KR'Корейский

Эмуляция цветовой схемы

Эмулируйте светлый или тёмный режим, чтобы проверитьprefers-color-schemeэффект медиазапросов.

Пример

Проверка тёмного режима
const darkContext = await browser.newContext({
  colorScheme: 'dark',
});

// Возможные значения: 'light', 'dark', 'no-preference'

Задайте разные цветовые схемы для разных проектов в файле конфигурации:

Пример

// Путь к файлу: playwright.config.ts
export default defineConfig({
  projects: [
    {
      name: 'chromium-light',
      use: { colorScheme: 'light' },
    },
    {
      name: 'chromium-dark',
      use: { colorScheme: 'dark' },
    },
  ],
});

Эмуляция разрешений

Используйтеcontext.grantPermissions()чтобы предоставить разрешения браузера.

Пример

await context.grantPermissions([
  'geolocation',        // Геолокация
  'notifications',      // Уведомления
  'camera',             // Камера
  'microphone',         // Микрофон
  'clipboard-read',     // Чтение буфера обмена
  'clipboard-write',    // Запись в буфер обмена
]);

// Очистить все разрешения
await context.clearPermissions();

Операции с Cookie

Через BrowserContext можно читать, добавлять и очищать Cookie.

Пример

// Добавить Cookie
await context.addCookies([
  {
    name: 'example_session',
    value: 'session_token_value',
    domain: 'www.example.com',
    path: '/',
    httpOnly: true,
    secure: true,
    sameSite: 'Lax',
  },
]);

// Получить все Cookies
const cookies = await context.cookies();
console.log(cookies);

// Получить Cookies для конкретного URL
const siteCookies = await context.cookies('https://www.example.com');

// Очистить все Cookies
await context.clearCookies();

Описание параметров Cookie

ПолеTypeОписание
namestringИмя Cookie
valuestringЗначение Cookie
domainstringДомен, для которого он действует
pathstringПуть, для которого он действует, по умолчанию'/'
expiresчислоВремя истечения (Unix timestamp)
httpOnlyлогическое значениеЯвляется ли он HTTP-only
secureлогическое значениеПередаётся ли он только по HTTPS
sameSitestringПолитика SameSite:'Strict' | 'Lax' | 'None'

Операции с localStorage и SessionStorage

Черезpage.evaluate()работают с хранилищем в контексте страницы.

Пример

// Установить localStorage
await page.evaluate(() => {
  localStorage.setItem('example_key', 'example_value');
});

// Прочитать localStorage
const value = await page.evaluate(() => {
  return localStorage.getItem('example_key');
});
console.log(value); // 'example_value'

// Очистить localStorage
await page.evaluate(() => {
  localStorage.clear();
});

Операции с Cookie и Storage следует выполнять заранееpage.goto()чтобы эти данные были доступны при загрузке страницы.

Другие расширения