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

import { chromium, devices } from 'playwright';

// 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

// Dateipfad: playwright.config.ts
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

const context = await browser.newContext({
  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

test('Peking-Standort simulieren', async ({ context, page }) => {
  // 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

const context = await browser.newContext({
  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:

localeSprache/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

// Dunkelmodus testen
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

// Dateipfad: playwright.config.ts
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

await context.grantPermissions([
  '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

// Cookie hinzufügen
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

FeldTypeBeschreibung
namestringCookie-Name
valuestringCookie-Wert
domainstringDomäne, für die es gilt
pathstringPfad, für den es gilt, Standard'/'
expiresnumberAblaufzeit (Unix-Zeitstempel)
httpOnlybooleschOb es HTTP-only ist
securebooleschOb es nur über HTTPS übertragen wird
sameSitestringSameSite-Richtlinie:'Strict' | 'Lax' | 'None'

localStorage- und SessionStorage-Operationen

Durchpage.evaluate()auf den Speicher im Seitenkontext zugreifen.

Beispiel

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

Cookie- und Storage-Operationen sollten ausgeführt werden, bevorpage.goto()um sicherzustellen, dass diese Daten verfügbar sind, wenn die Seite geladen wird.

Andere Erweiterungen