跳至主要内容

模拟

简介​

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

设备​

Playwright可以通过在创建上下文时指定setDeviceScaleFactor、setHasTouch、setIsMobile、setScreenSize、setUserAgent和setViewportSize选项来模拟各种设备，使用Browser.newContext()方法。

视口​

视口包含在设备中，但您可以通过Page.setViewportSize()为某些测试覆盖它。

测试文件：

同样的功能在测试文件中也适用。

// Create context with given viewport
BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setViewportSize(1280, 1024));

// Resize viewport for individual page
page.setViewportSize(1600, 1200);

// Emulate high-DPI
BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setViewportSize(2560, 1440)
  .setDeviceScaleFactor(2));

isMobile​

是否考虑元视口标签并启用了触摸事件。

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .isMobile(false));

区域设置与时区​

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

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setLocale("de-DE")
  .setTimezoneId("Europe/Berlin"));
Bing in german lang and timezone

权限​

允许应用显示系统通知。

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setPermissions(Arrays.asList("notifications")));

允许特定域的通知。

context.grantPermissions(Arrays.asList("notifications"),
  new BrowserContext.GrantPermissionsOptions().setOrigin("https://skype.com"));

使用BrowserContext.clearPermissions()撤销所有权限。

context.clearPermissions();

地理位置​

授予 "geolocation" 权限并将地理位置设置为特定区域。

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setGeolocation(41.890221, 12.492348)
  .setPermissions(Arrays.asList("geolocation")));
geolocation for italy on bing maps

稍后更改位置：

context.setGeolocation(new Geolocation(48.858455, 2.294474));

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

配色方案与媒体​

模拟用户的"colorScheme"。支持的值为'light'和'dark'。您还可以通过Page.emulateMedia()来模拟媒体类型。

// Create context with dark mode
BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setColorScheme(ColorScheme.DARK)); // or "light"

// Create page with dark mode
Page page = browser.newPage(new Browser.NewPageOptions()
  .setColorScheme(ColorScheme.DARK)); // or "light"

// Change color scheme for the page
page.emulateMedia(new Page.EmulateMediaOptions().setColorScheme(ColorScheme.DARK));

// Change media for page
page.emulateMedia(new Page.EmulateMediaOptions().setMedia(Media.PRINT));
playwright web in dark mode

用户代理​

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

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setUserAgent("My user agent"));

离线​

模拟网络处于离线状态。

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .setOffline(true));

启用JavaScript​

模拟用户禁用JavaScript的场景。

BrowserContext context = browser.newContext(new Browser.NewContextOptions()
  .javaScriptEnabled(false));