Playwright Mobile Tests

Playwright Mobile Testing, das hauptsächlich Funktionen wie die Simulation mobiler Geräte, Geolokalisierung und Berechtigungssteuerung umfasst.

Neben der Simulation von Desktop-Browsern unterstützt Playwright auchdas Testen mobiler Geräte, einschließlich:

  • Simulation verschiedener Telefonmodelle (Bildschirmgröße, Auflösung, UA usw.)
  • Simulation von Touch-Ereignissen (Tippen, Wischen, langes Drücken)
  • Simulation der Geolokalisierung (GPS)
  • Simulation von Berechtigungen (Kamera, Standort, Benachrichtigungen)

Dadurch können wir auf einem PC mit Effekten testen, die denen eines echten Telefons nahekommen.


Geräte simulieren

Playwright bietet einige gängige Gerätekonfigurationen (basierend aufChrome DevToolsGeräte-Deskriptoren) und kanndevicesaufgerufen werden.

Beispiel

const { chromium, devices } = require('playwright');

(async () => {
  const iPhone = devices['iPhone 12']; // Gerät auswählen

  const browser = await chromium.launch();
  const context = await browser.newContext({
    ...iPhone  // Gerätekonfiguration anwenden
  });

  const page = await context.newPage();
  await page.goto('https://www.example.com');

  await page.screenshot({ path: 'mobile.png' });
  await browser.close();
})();

Was simuliert werden kann:

  • Bildschirmauflösung(width、height、deviceScaleFactor)
  • User-Agent(simulierter mobiler UA)
  • Unterstützung für Touch-Events
  • Wechsel zwischen Quer- und Hochformat

Simulieren von Touch-Operationen

Playwright ermöglichtTouch-Events。

Häufige Operationen:

1. Tippen

await page.tap('button#submit');

2. Wischen/Ziehen

await page.touchscreen.tap(200, 300); // 点击指定坐标
await page.touchscreen.swipe(200, 300, 200, 800); // 自定义封装,模拟滑动

3. Langes Drücken

await page.touchscreen.down(200, 300);
await page.waitForTimeout(1000); // 按住 1 秒
await page.touchscreen.up();

Simulieren der Geolokalisierung

Kann dieGPS-Positionierung des Telefons simulieren。

Beispiel

const context = await browser.newContext({
  geolocation: { longitude: 116.4074, latitude: 39.9042 }, // Beijing
  permissions: ['geolocation']
});

const page = await context.newPage();
await page.goto('https://www.google.com/maps');

Berechtigungen simulieren

Playwright unterstützt das Erteilen oder Verweigern gängiger Berechtigungen, zum Beispiel:

  • geolocation(Geolokalisierung)
  • camera(Kamera)
  • microphone(Mikrofon)
  • notifications(Benachrichtigungen)
const context = await browser.newContext({
  permissions: ['geolocation', 'notifications']
});

Simulieren des Querformat-/Hochformat-Wechsels

Durch Ändernviewportder Konfiguration.

await context.newPage({
  viewport: { width: 812, height: 375 }, // 横屏
  isMobile: true
});

Vollständiges Beispiel: Mobiles Testen

Beispiel

const { chromium, devices } = require('playwright');

(async () => {
  const pixel5 = devices['Pixel 5'];

  const browser = await chromium.launch({ headless: false });
  const context = await browser.newContext({
    ...pixel5,
    geolocation: { longitude: 121.4737, latitude: 31.2304 }, // Shanghai
    permissions: ['geolocation']
  });

  const page = await context.newPage();
  await page.goto('https://www.google.com/maps');

  await page.screenshot({ path: 'mobile-map.png' });

  await browser.close();
})();

Gängige APIs

API Beschreibung Beispiel
devices['iPhone 12'] Gerätekonfiguration abrufen const iphone = devices['iPhone 12']
context = browser.newContext({...device}) Gerätesimulation aktivieren ...iPhone
page.tap(selector) Element antippen await page.tap('#btn')
page.touchscreen.tap(x,y) An Koordinaten klicken await page.touchscreen.tap(100,200)
page.touchscreen.down(x,y) Finger aufsetzen await page.touchscreen.down(100,200)
page.touchscreen.up() Finger anheben await page.touchscreen.up()
geolocation Geolokalisierung festlegen { longitude: 120, latitude: 30 }
permissions Berechtigungen festlegen ['geolocation','camera']
viewport Bildschirmbreite und -höhe festlegen { width: 812, height: 375 }
isMobile Mobilmodus aktivieren isMobile: true

Gängige Geräte

Playwright verfügt über eine integrierte Liste gängiger Geräte, darunteriPhone-Serie, Pixel-Serie, iPad, usw.

Playwright-Liste gängiger Geräte

Playwright enthält Dutzende gängiger Gerätekonfigurationen (basierend auf Chrome DevTools-Daten). Bei Verwendung über:

const { devices } = require('playwright');
const iphone = devices['iPhone 12'];

Sie können die Konfigurationsparameter dieses Geräts abrufen.

iPhone-Serie

Gerätename viewport deviceScaleFactor UA (Abk.) Hinweise
iPhone SE 375 × 667 2 Safari iOS Kleiner Bildschirm klassisch
iPhone 6 375 × 667 2 Safari iOS Älteres Modell
iPhone 7 375 × 667 2 Safari iOS Älteres Modell
iPhone 8 375 × 667 2 Safari iOS Häufig
iPhone 8 Plus 414 × 736 3 Safari iOS Großer Bildschirm
iPhone X 375 × 812 3 Safari iOS Notch-Bildschirm
iPhone 11 414 × 896 2 Safari iOS Häufig
iPhone 11 Pro 375 × 812 3 Safari iOS
iPhone 11 Pro Max 414 × 896 3 Safari iOS
iPhone 12 390 × 844 3 Safari iOS Beliebt
iPhone 12 Pro 390 × 844 3 Safari iOS
iPhone 12 Pro Max 428 × 926 3 Safari iOS Großer Bildschirm
iPhone 12 Mini 360 × 780 3 Safari iOS Kleiner Bildschirm
iPhone 13 390 × 844 3 Safari iOS Beliebt
iPhone 13 Pro 390 × 844 3 Safari iOS
iPhone 13 Pro Max 428 × 926 3 Safari iOS
iPhone 13 Mini 360 × 780 3 Safari iOS

Google Pixel-Serie

Gerätename viewport deviceScaleFactor UA (Abk.) Hinweise
Pixel 2 411 × 731 2.6 Chrome Android Älteres Modell
Pixel 2 XL 411 × 823 3.5 Chrome Android Großer Bildschirm
Pixel 3 393 × 786 2.75 Chrome Android
Pixel 3 XL 412 × 847 3.5 Chrome Android
Pixel 4 353 × 745 2.75 Chrome Android
Pixel 4 XL 412 × 869 3.5 Chrome Android
Pixel 5 393 × 851 2.75 Chrome Android Empfohlen

iPad-Serie

Gerätename viewport deviceScaleFactor UA (Abk.) Hinweise
iPad (gen 6) 768 × 1024 2 Safari iOS Häufig
iPad (gen 7) 810 × 1080 2 Safari iOS
iPad Air 820 × 1180 2 Safari iOS
iPad Mini 768 × 1024 2 Safari iOS
iPad Pro 11 834 × 1194 2 Safari iOS
iPad Pro 12.9 1024 × 1366 2 Safari iOS Großer Bildschirm

Andere Android-Modelle

Gerätename viewport deviceScaleFactor UA (Abk.) Hinweise
Galaxy S5 360 × 640 3 Chrome Android Älter
Galaxy S8 360 × 740 4 Chrome Android
Galaxy S9+ 412 × 846 4.5 Chrome Android
Galaxy Note 3 360 × 640 3 Chrome Android
Galaxy Note 9 414 × 846 4.5 Chrome Android
Galaxy A51/71 412 × 914 2.63 Chrome Android Beliebt

Nutzung

Beispiel

const { chromium, devices } = require('playwright');

(async () => {
  const iPhone = devices['iPhone 12'];
  const browser = await chromium.launch({ headless: false });
  const context = await browser.newContext({
    ...iPhone,
    geolocation: { longitude: 116.4074, latitude: 39.9042 }, // Beijing
    permissions: ['geolocation']
  });
  const page = await context.newPage();
  await page.goto('https://www.example.com');
  await page.screenshot({ path: 'iphone12.png' });
  await browser.close();
})();
Andere Erweiterungen