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
(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
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
(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
(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();
})();