メインコンテンツにスキップ

エミュレーション

イントロダクション​

Playwright を使用すると、あらゆるブラウザでアプリをテストできるだけでなく、携帯電話やタブレットなどの実際のデバイスをエミュレートすることもできます。エミュレートしたいデバイスを設定するだけで、Playwright は "userAgent"、"screenSize"、"viewport"、および "hasTouch" が有効になっているかどうかなど、ブラウザの動作をシミュレートします。また、すべてのテストまたは特定のテストに対して "geolocation"、"locale"、"timezone" をエミュレートしたり、通知を表示したり、"colorScheme" を変更したりするために "permissions" を設定したりすることもできます。

デバイス​

Playwright には、選択されたデスクトップ、タブレット、およびモバイルデバイス用の デバイスパラメータのレジストリ が playwright.devices を使用して付属しています。これは、ユーザーエージェント、画面サイズ、ビューポート、タッチが有効になっているかどうかなど、特定のデバイスのブラウザの動作をシミュレートするために使用できます。すべてのテストは、指定されたデバイスパラメータで実行されます。

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)
playwright.dev website emulated for iPhone 13

ビューポート​

ビューポートはデバイスに含まれていますが、一部のテストでは page.set_viewport_size() でオーバーライドできます。

テストファイル

同じことがテストファイル内でも機能します。

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

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

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

isMobile​

メタビューポートタグが考慮され、タッチイベントが有効になっているかどうか。

context = browser.new_context(
  isMobile=false
)

ロケールとタイムゾーン​

ユーザーのロケールとタイムゾーンをエミュレートします。これらは、設定内のすべてのテストに対してグローバルに設定でき、特定のテストに対してオーバーライドできます。

context = browser.new_context(
  locale='de-DE',
  timezone_id='Europe/Berlin',
)
Bing in german lang and timezone

許可​

アプリがシステム通知を表示することを許可します。

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

特定のドメインの通知を許可します。

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

browser_context.clear_permissions() で、すべての許可を取り消します。

context.clear_permissions()

地理位置情報​

"geolocation" 許可を付与し、地理位置情報を特定の領域に設定します。

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

後で場所を変更する

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

注 地理位置情報は、コンテキスト内のすべてのページに対してのみ変更できます。

配色とメディア​

ユーザーの "colorScheme" をエミュレートします。サポートされている値は 'light' と 'dark' です。 page.emulate_media() を使用して、メディアタイプをエミュレートすることもできます。

# 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')
playwright web in dark mode

ユーザーエージェント​

ユーザーエージェントはデバイスに含まれているため、変更する必要はほとんどありませんが、別のユーザーエージェントをテストする必要がある場合は、userAgent プロパティでオーバーライドできます。

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

オフライン​

ネットワークがオフラインになっている状態をエミュレートします。

context = browser.new_context(
  offline=True
)

JavaScript 有効​

JavaScript が無効になっているユーザーシナリオをエミュレートします。

context = browser.new_context(
  java_script_enabled=False
)