Эмуляция

Введение

С помощью Playwright вы можете тестировать свое приложение в любом браузере, а также эмулировать реальное устройство, такое как мобильный телефон или планшет. Просто настройте устройства, которые вы хотите эмулировать, и Playwright будет симулировать поведение браузера, такое как "userAgent", "screenSize", "viewport" и наличие поддержки "hasTouch". Вы также можете эмулировать "geolocation", "locale" и "timezone" для всех тестов или для конкретного теста, а также установить "permissions" для показа уведомлений или изменить "colorScheme".

Устройства

Playwright поставляется с реестром параметров устройств, используя playwright.devices для выбранных настольных, планшетных и мобильных устройств. Это можно использовать для симуляции поведения браузера для конкретного устройства, такого как user agent, размер экрана, viewport и наличие поддержки touch. Все тесты будут выполняться с указанными параметрами устройства.

Sync

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
    iphone_13 = playwright.devices['iPhone 13']
    browser = playwright.webkit.launch(headless=False)
    context = browser.new_context(
        **iphone_13,
    )

with sync_playwright() as playwright:
    run(playwright)

Async

import asyncio
from playwright.async_api import async_playwright, Playwright

async def run(playwright: Playwright):
    iphone_13 = playwright.devices['iPhone 13']
    browser = await playwright.webkit.launch(headless=False)
    context = await browser.new_context(
        **iphone_13,
    )

async def main():
    async with async_playwright() as playwright:
        await run(playwright)
asyncio.run(main())

Viewport

Viewport включен в устройство, но вы можете переопределить его для некоторых тестов с помощью page.set_viewport_size().

Файл теста:

То же самое работает внутри файла теста.

Sync

# Создать контекст с заданным viewport
context = browser.new_context(
  viewport={ 'width': 1280, 'height': 1024 }
)

# Изменить размер viewport для отдельной страницы
page.set_viewport_size({"width": 1600, "height": 1200})

# Эмулировать высокое разрешение DPI
context = browser.new_context(
  viewport={ 'width': 2560, 'height': 1440 },
  device_scale_factor=2,
)

Async

# Создать контекст с заданным viewport
context = await browser.new_context(
  viewport={ 'width': 1280, 'height': 1024 }
)

# Изменить размер viewport для отдельной страницы
await page.set_viewport_size({"width": 1600, "height": 1200})

# Эмулировать высокое разрешение DPI
context = await browser.new_context(
  viewport={ 'width': 2560, 'height': 1440 },
  device_scale_factor=2,
)

isMobile

Учитывается ли мета-тег viewport и включены ли события касания.

Sync

context = browser.new_context(
  isMobile=false
)

Async

context = await browser.new_context(
  isMobile=false
)

Локаль и Часовой пояс

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

Sync

context = browser.new_context(
  locale='de-DE',
  timezone_id='Europe/Berlin',
)

Async

context = await browser.new_context(
  locale='de-DE',
  timezone_id='Europe/Berlin',
)

Разрешения

Разрешите приложению показывать системные уведомления.

Sync

context = browser.new_context(
  permissions=['notifications'],
)

Async

context = await browser.new_context(
  permissions=['notifications'],
)

Разрешите уведомления для конкретного домена.

Sync

context.grant_permissions(['notifications'], origin='https://skype.com')

Async

await context.grant_permissions(['notifications'], origin='https://skype.com')

Отмените все разрешения с помощью browser_context.clear_permissions().

Sync

context.clear_permissions()

Async

await context.clear_permissions()

Геолокация

Предоставьте разрешения на "geolocation" и установите геолокацию для конкретной области.

Sync

context = browser.new_context(
  geolocation={"longitude": 41.890221, "latitude": 12.492348},
  permissions=["geolocation"]
)

Async

context = await browser.new_context(
  geolocation={"longitude": 41.890221, "latitude": 12.492348},
  permissions=["geolocation"]
)

Измените местоположение позже:

Sync

context.set_geolocation({"longitude": 48.858455, "latitude": 2.294474})

Async

await context.set_geolocation({"longitude": 48.858455, "latitude": 2.294474})

Примечание: вы можете изменить геолокацию только для всех страниц в контексте.

Цветовая схема и Медиа

Эмулируйте "colorScheme" пользователя. Поддерживаемые значения: 'light' и 'dark'. Вы также можете эмулировать тип медиа с помощью page.emulate_media().

Sync

# Создать контекст с темным режимом
context = browser.new_context(
  color_scheme='dark' # или 'light'
)

# Создать страницу с темным режимом
page = browser.new_page(
  color_scheme='dark' # или 'light'
)

# Изменить цветовую схему для страницы
page.emulate_media(color_scheme='dark')

# Изменить медиа для страницы
page.emulate_media(media='print')

Async

# Создать контекст с темным режимом
context = await browser.new_context(
  color_scheme='dark' # или 'light'
)

# Создать страницу с темным режимом
page = await browser.new_page(
  color_scheme='dark' # или 'light'
)

# Изменить цветовую схему для страницы
await page.emulate_media(color_scheme='dark')

# Изменить медиа для страницы
await page.emulate_media(media='print')

User Agent

User Agent включен в устройство, и поэтому вам редко потребуется его изменять, однако, если вам нужно протестировать другой user agent, вы можете переопределить его с помощью свойства userAgent.

Sync

context = browser.new_context(
  user_agent='My user agent'
)

Async

context = await browser.new_context(
  user_agent='My user agent'
)

Офлайн

Эмуляция состояния, когда сеть отключена.

Sync

context = browser.new_context(
  offline=True
)

Async

context = await browser.new_context(
  offline=True
)

Включен JavaScript

Эмуляция пользовательского сценария, когда JavaScript отключен.

Sync

context = browser.new_context(
  java_script_enabled=False
)

Async

context = await browser.new_context(
  java_script_enabled=False
)