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
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
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:
| Voreinstellungsname | Gerätetyp | Viewport-Größe |
|---|---|---|
Desktop Chrome | Desktop | 1280×720 |
Desktop Firefox | Desktop | 1280×720 |
Desktop Safari | Desktop | 1280×720 |
iPhone 15 | Mobil | 393×852 |
Pixel 7 | Mobil | 412×915 |
iPad Pro | Tablet | 1024×1366 |
Benutzerdefinierte Projektkonfiguration
Du kannst in der Projektkonfigurationusedie globale Konfiguration überschreiben:
Beispiel
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
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
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',
},
},
],
});