Эмуляция устройств и браузеров Playwright
В этой главе рассказывается, как имитировать параметры среды браузера, такие как мобильные устройства, геолокация, часовой пояс, язык и цветовая схема, в Playwright.
Эмуляция мобильных устройств
Playwright имеет множество встроенных предустановок устройств, которые позволяют имитировать область просмотра, User-Agent и сенсорное поведение различных телефонов и планшетов.
Использование предустановки devices
Используяdevicesобъект, вы можете быстро имитировать конкретное устройство.
Пример
// Имитировать 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
Использование предустановок устройств в файле конфигурации:
Пример
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'mobile',
use: { ...devices['Pixel 7'] },
},
],
});
Ручная настройка области просмотра
Если вам не нужна полная предустановка устройства, вы можете вручную указать размер области просмотра.
Пример
viewport: { width: 375, height: 812 }, // Размер области просмотра
deviceScaleFactor: 3, // Соотношение пикселей устройства (экран Retina)
isMobile: true, // Включить мобильный режим
hasTouch: true, // Включить эмуляцию касаний
userAgent: 'Mozilla/5.0 ... Mobile ...', // Пользовательский UA
});
Эмуляция геолокации
Playwright может имитировать информацию о GPS-местоположении устройства.
Пример
// Предоставить разрешение на геолокацию
await context.grantPermissions(['geolocation']);
// Задать конкретные широту и долготу (координаты Пекина)
await context.setGeolocation({
latitude: 39.9042,
longitude: 116.4074,
});
await page.goto('https://www.example.com/map');
// Страница получит информацию о местоположении Пекина
});
Эмуляция часового пояса и языка
Проверьте интернационализацию и функциональность, связанную с часовым поясом, установив локаль и часовой пояс.
Пример
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'
Задайте разные цветовые схемы для разных проектов в файле конфигурации:
Пример
export default defineConfig({
projects: [
{
name: 'chromium-light',
use: { colorScheme: 'light' },
},
{
name: 'chromium-dark',
use: { colorScheme: 'dark' },
},
],
});
Эмуляция разрешений
Используйтеcontext.grantPermissions()чтобы предоставить разрешения браузера.
Пример
'geolocation', // Геолокация
'notifications', // Уведомления
'camera', // Камера
'microphone', // Микрофон
'clipboard-read', // Чтение буфера обмена
'clipboard-write', // Запись в буфер обмена
]);
// Очистить все разрешения
await context.clearPermissions();
Операции с Cookie
Через BrowserContext можно читать, добавлять и очищать 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 | Описание |
|---|---|---|
name | string | Имя Cookie |
value | string | Значение Cookie |
domain | string | Домен, для которого он действует |
path | string | Путь, для которого он действует, по умолчанию'/' |
expires | число | Время истечения (Unix timestamp) |
httpOnly | логическое значение | Является ли он HTTP-only |
secure | логическое значение | Передаётся ли он только по HTTPS |
sameSite | string | Политика SameSite:'Strict' | 'Lax' | 'None' |
Операции с localStorage и SessionStorage
Черезpage.evaluate()работают с хранилищем в контексте страницы.
Пример
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()чтобы эти данные были доступны при загрузке страницы.