Skip to main content

模拟

使用 Playwright，您可以在任何浏览器上测试您的应用程序，也可以模拟真实设备，如手机或平板电脑。只需配置您想要模拟的设备，Playwright 就会模拟浏览器行为，例如 "userAgent"、"screenSize"、"viewport" 以及是否启用了 "hasTouch"。您还可以为所有测试或特定测试模拟 "geolocation"、"locale" 和 "timezone"，以及设置 "permissions" 以显示通知或更改 "colorScheme"。

Devices​

Playwright 附带了一个 设备参数注册表，使用 playwright.devices 用于选定的桌面、平板电脑和移动设备。它可用于模拟特定设备的浏览器行为，例如用户代理、屏幕尺寸、视口以及是否启用了触摸。所有测试都将使用指定的设备参数运行。

from playwright.sync_api import sync_playwright

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

with sync_playwright() as playwright:
    run(playwright)

Viewport​

视口包含在设备中，但您可以使用 page.set_viewport_size(viewport_size) 为某些测试覆盖它。

这在 describe 块中同样有效。

# Create context with given viewport
context = browser.new_context(
  viewport={ 'width': 1280, 'height': 1024 }
)

# Resize viewport for individual page
await page.set_viewport_size({"width": 1600, "height": 1200})

# Emulate high-DPI
context = browser.new_context(
  viewport={ 'width': 2560, 'height': 1440 },
  device_scale_factor=2,

Locale & Timezone​

模拟用户区域设置和时区，可以在配置中为所有测试全局设置，然后为特定测试覆盖。

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

Permissions​

允许应用显示系统通知。

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

允许测试请求当前位置。

context.grant_permissions(['geolocation'])

允许特定域的通知。

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

使用 browser_context.clear_permissions() 撤销所有权限。

context.clear_permissions()

Geolocation​

创建一个授予 "geolocation" 权限并将地理位置设置为特定区域的测试。

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

稍后更改位置：

context.set_geolocation({"longitude": 29.979097, "latitude": 31.134256})

注意 您只能更改上下文中所有页面的地理位置。

Color Scheme and Media​

创建一个模拟用户 "colorScheme" 的测试。支持的值为 'light'、'dark'、'no-preference'。您还可以使用 page.emulate_media(**kwargs) 模拟媒体类型。

# Create context with dark mode
context = browser.new_context(
  color_scheme='dark' # or 'light'
)

# Create page with dark mode
page = browser.new_page(
  color_scheme='dark' # or 'light'
)

# Change color scheme for the page
page.emulate_media(color_scheme='dark')

# Change media for page
page.emulate_media(media='print')

User Agent​

用户代理包含在设备中，因此您很少需要更改它，但是如果您确实需要测试不同的用户代理，则可以使用 userAgent 属性覆盖它。

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

JavaScript Enabled​

模拟禁用 JavaScript 的用户场景。