Playwright Multi-Projekt-Konfiguration (Projekte)

Dieses Kapitel zeigt, wie Tests in mehreren Browsern und auf mehreren Geräten durch die Konfiguration von Projekten ausgeführt werden, sowie die Verwendung von Projektabhängigkeiten.


Was ist ein Projekt

In Playwright steht ein Projekt für eine Gruppe vonTests, die unter bestimmten Browser- und Gerätekonfigurationen ausgeführt werden.

Durch die Konfiguration mehrerer Projekte können Sie denselben Satz Testcode auf Chromium, Firefox, WebKit und mobilen Geräten ausführen.


Grundlegende Multi-Browser-Konfiguration

Beispiel

// Dateipfad: playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [
    {
      name: 'chromium',
      use: { ...devices['Desktop Chrome'] },
    },
    {
      name: 'firefox',
      use: { ...devices['Desktop Firefox'] },
    },
    {
      name: 'webkit',
      use: { ...devices['Desktop Safari'] },
    },
  ],
});

Tests für einen bestimmten Browser ausführen:

# 仅在 Chromium 上运行
npx playwright test --project=chromium

# 在 Chromium 和 Firefox 上运行
npx playwright test --project=chromium --project=firefox

devices Geräte-Presets

Playwright enthält eine große Anzahl integrierter Geräte-Presets (aus@playwright/testvondevices), die den Viewport, User-Agent, Pixelverhältnis usw. realer Geräte simulieren.

Beispiel

import { defineConfig, devices } from '@playwright/test';

export default defineConfig({
  projects: [
    // Desktop
    {
      name: 'desktop-chrome',
      use: { ...devices['Desktop Chrome'] },
    },

    // Mobile
    {
      name: 'mobile-iphone',
      use: { ...devices['iPhone 15'] },
    },
    {
      name: 'mobile-pixel',
      use: { ...devices['Pixel 7'] },
    },

    // Tablet
    {
      name: 'tablet-ipad',
      use: { ...devices['iPad Pro'] },
    },
  ],
});

Häufig verwendete Gerätevoreinstellungen:

VoreinstellungsnameGerätetypViewport-Größe
Desktop ChromeDesktop1280×720
Desktop FirefoxDesktop1280×720
Desktop SafariDesktop1280×720
iPhone 15Mobil393×852
Pixel 7Mobil412×915
iPad ProTablet1024×1366

Benutzerdefinierte Projektkonfiguration

Du kannst in der Projektkonfigurationusedie globale Konfiguration überschreiben:

Beispiel

export default defineConfig({
  Verwenden Sie: {
    baseURL: 'http://localhost:3000',
    locale: 'zh-CN',
    timezone: 'Asia/Shanghai',
  },

  projects: [
    {
      name: 'chromium-desktop',
      Verwenden Sie: {
        ...devices['Desktop Chrome'],
        // Globale Locale und Zeitzone erben
      },
    },
    {
      name: 'chromium-mobile',
      Verwenden Sie: {
        ...devices['Pixel 7'],
        // Englische Umgebung erzwingen
        locale: 'en-US',
        timezone: 'America/New_York',
      },
    },
    // Dunkelmodus testen
    {
      name: 'chromium-dark',
      Verwenden Sie: {
        ...devices['Desktop Chrome'],
        colorScheme: 'dark',
      },
    },
    // Light-Modus testen
    {
      name: 'chromium-light',
      Verwenden Sie: {
        ...devices['Desktop Chrome'],
        colorScheme: 'light',
      },
    },
  ],
});

Projektabhängigkeiten

Ein Projekt kann von einem anderen Projekt abhängen, wodurch sichergestellt wird, dass das Projekt, von dem es abhängt, zuerst ausgeführt wird.

Der häufigste Anwendungsfall ist, dass ein Setup-Projekt (Authentifizierung) zuerst ausgeführt wird und andere Projekte davon abhängen.

Beispiel

export default defineConfig({
  projects: [
    // Setup-Projekt — Authentifizierungszustand generieren
    {
      name: 'setup',
      testMatch: /auth\.setup\.ts/,
    },

    // Testprojekt hängt von setup ab, wodurch sichergestellt wird, dass der Authentifizierungszustand zuerst generiert wird
    {
      name: 'chromium',
      Verwenden Sie: {
        ...devices['Desktop Chrome'],
        storageState: 'playwright/.auth/user.json',
      },
      dependencies: ['setup'],
    },
    {
      name: 'firefox',
      Verwenden Sie: {
        ...devices['Desktop Firefox'],
        storageState: 'playwright/.auth/user.json',
      },
      dependencies: ['setup'],
    },
  ],
});

setupEin Projekt wird nur einmal ausgeführt, und alle Projekte, die davon abhängen, warten auf dessen Abschluss, bevor sie starten.


Konfiguration über testProject teilen

Damit mehrere Projekte eine Konfiguration ohne Wiederholung gemeinsam nutzen können, können Sie ein Basisprojekt extrahieren:

Beispiel

// Dateipfad: playwright.config.ts
import { defineConfig, devices } from '@playwright/test';

const desktopProject = {
  Verwenden Sie: {
    ...devices['Desktop Chrome'],
    viewport: { width: 1920, height: 1080 },
    locale: 'zh-CN',
  },
} as const;

export default defineConfig({
  projects: [
    {
      name: 'chromium',
      ...desktopProject,  // desktopProject-Konfiguration erben
      Verwenden Sie: {
        ...desktopProject.use,  // Zuerst erben
        browserName: 'chromium', // Dann überschreiben
      },
    },
    {
      name: 'firefox',
      Verwenden Sie: {
        ...devices['Desktop Firefox'],
        // viewport und locale überschreiben
        viewport: { width: 1920, height: 1080 },
        locale: 'zh-CN',
      },
    },
  ],
});
Andere Erweiterungen