Playwright-Geräte- und Browser-Emulation
Dieses Kapitel führt ein, wie man Browserumgebungsparameter wie mobile Geräte, Geolokalisierung, Zeitzone, Sprache und Farbschema in Playwright simuliert.
Emulation mobiler Geräte
Playwright verfügt über eine große Anzahl integrierter Geräte-Presets, mit denen sich Viewport, User-Agent und Touch-Verhalten verschiedener Telefone und Tablets simulieren lassen.
Verwenden des devices-Presets
Mit derdevices-Objekts können Sie schnell ein bestimmtes Gerät simulieren.
Beispiel
// iPhone 15 simulieren
const browser = await chromium.launch();
const context = await browser.newContext(devices['iPhone 15']);
const page = await context.newPage();
await page.goto('https://www.example.com/');
// Die Seite wird mit dem Viewport und UA des iPhone 15 gerendert
Verwenden von Geräte-Presets in der Konfigurationsdatei:
Beispiel
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
projects: [
{
name: 'mobile',
use: { ...devices['Pixel 7'] },
},
],
});
Manuelles Konfigurieren des Viewports
Wenn Sie kein vollständiges Geräte-Preset benötigen, können Sie die Viewport-Größe manuell angeben.
Beispiel
viewport: { width: 375, height: 812 }, // Viewport-Größe
deviceScaleFactor: 3, // Gerätepixelverhältnis (Retina-Bildschirm)
isMobile: true, // Mobilmodus aktivieren
hasTouch: true, // Touch-Emulation aktivieren
userAgent: 'Mozilla/5.0 ... Mobile ...', // Benutzerdefinierter UA
});
Geolokalisierungs-Emulation
Playwright kann die GPS-Standortinformationen des Geräts simulieren.
Beispiel
// Geolokalisierungsberechtigung erteilen
await context.grantPermissions(['geolocation']);
// Spezifische Breiten- und Längengrade festlegen (Peking-Koordinaten)
await context.setGeolocation({
latitude: 39.9042,
longitude: 116.4074,
});
await page.goto('https://www.example.com/map');
// Die Seite ruft die Standortinformationen von Peking ab
});
Zeitzonen- und Sprach-Emulation
Überprüfen Sie Funktionen für Internationalisierung und Zeitzonen durch Festlegen von Gebietsschema und Zeitzone.
Beispiel
locale: 'zh-CN', // Browsersprache auf vereinfachtes Chinesisch setzen
timezone: 'Asia/Shanghai', // Zeitzone auf Shanghai (UTC+8) setzen
});
// Global in der Konfigurationsdatei festlegen
export default defineConfig({
Verwenden Sie: {
locale: 'en-US',
timezone: 'America/New_York',
},
});
Häufige Locale-Werte:
| locale | Sprache/Region |
|---|---|
'zh-CN' | Vereinfachtes Chinesisch (China) |
'zh-TW' | Traditionelles Chinesisch (Taiwan) |
'en-US' | Englisch (Vereinigte Staaten) |
'ja-JP' | Japanisch |
'ko-KR' | Koreanisch |
Farbschema-Emulation
Hellen oder dunklen Modus emulieren, umprefers-color-schemedie Auswirkung von Media Queries zu testen.
Beispiel
const darkContext = await browser.newContext({
colorScheme: 'dark',
});
// Mögliche Werte: 'light', 'dark', 'no-preference'
Legen Sie verschiedene Farbschemata für verschiedene Projekte in der Konfigurationsdatei fest:
Beispiel
export default defineConfig({
projects: [
{
name: 'chromium-light',
use: { colorScheme: 'light' },
},
{
name: 'chromium-dark',
use: { colorScheme: 'dark' },
},
],
});
Berechtigungs-Emulation
Verwenden Siecontext.grantPermissions()um Browser-Berechtigungen zu erteilen.
Beispiel
'geolocation', // Geolokalisierung
'notifications', // Benachrichtigungen
'camera', // Kamera
'microphone', // Mikrofon
'clipboard-read', // Zwischenablage lesen
'clipboard-write', // In die Zwischenablage schreiben
]);
// Alle Berechtigungen löschen
await context.clearPermissions();
Cookie-Operationen
Über BrowserContext können Sie Cookies lesen, hinzufügen und löschen.
Beispiel
await context.addCookies([
{
name: 'example_session',
value: 'session_token_value',
domain: 'www.example.com',
path: '/',
httpOnly: true,
secure: true,
sameSite: 'Lax',
},
]);
// Alle Cookies abrufen
const cookies = await context.cookies();
console.log(cookies);
// Cookies für eine bestimmte URL abrufen
const siteCookies = await context.cookies('https://www.example.com');
// Alle Cookies löschen
await context.clearCookies();
Beschreibung der Cookie-Parameter
| Feld | Type | Beschreibung |
|---|---|---|
name | string | Cookie-Name |
value | string | Cookie-Wert |
domain | string | Domäne, für die es gilt |
path | string | Pfad, für den es gilt, Standard'/' |
expires | number | Ablaufzeit (Unix-Zeitstempel) |
httpOnly | boolesch | Ob es HTTP-only ist |
secure | boolesch | Ob es nur über HTTPS übertragen wird |
sameSite | string | SameSite-Richtlinie:'Strict' | 'Lax' | 'None' |
localStorage- und SessionStorage-Operationen
Durchpage.evaluate()auf den Speicher im Seitenkontext zugreifen.
Beispiel
await page.evaluate(() => {
localStorage.setItem('example_key', 'example_value');
});
// localStorage lesen
const value = await page.evaluate(() => {
return localStorage.getItem('example_key');
});
console.log(value); // 'example_value'
// localStorage leeren
await page.evaluate(() => {
localStorage.clear();
});
Andere ErweiterungenCookie- und Storage-Operationen sollten ausgeführt werden, bevor
page.goto()um sicherzustellen, dass diese Daten verfügbar sind, wenn die Seite geladen wird.