Playwright Page Object Model (POM)
Dieses Kapitel führt in die Designphilosophie und Implementierung des Page Object Model ein, um dir zu helfen, große Testsuiten zu organisieren.
Was ist POM
Das Page Object Model ist ein Testentwurfsmuster, das Seitenelemente und Operationenin unabhängige Klassenin.
Jedes Seitenobjekt repräsentiert eine Seite oder Komponente in einer Webanwendung und enthält die Locators und Operationsmethoden für diese Seite.
Vorteile von POM
| Vorteil | Beschreibung |
|---|---|
| Vereinfacht das Testschreiben | Testcode verwendet High-Level-APIs (wie z. B.loginPage.login('user', 'pass')) anstelle von rohen Locator-Operationen |
| Reduziert die Wartungskosten | Änderungen an der Seitenstruktur erfordern nur die Änderung der Page-Object-Klasse, nicht jeden einzelnen Test |
| Verbessert die Lesbarkeit | Testcode liest sich eher wie eine Fachsprache und ist dadurch auch für nicht-technische Personen verständlich |
| Vermeidet Duplikate | Die gleichen Locators und Operationen müssen nur einmal definiert werden |
Erstellen einer Page-Object-Klasse
Im Folgenden wird die EXAMPLE-Website als Beispiel verwendet, um ein Page Object für eine Login-Seite zu erstellen.
Beispiel
import { type Page, type Locator, expect } from '@playwright/test';
export class LoginPage {
readonly page: Page;
// Alle Locators als schreibgeschützte Eigenschaften deklarieren
readonly usernameInput: Locator;
readonly passwordInput: Locator;
readonly loginButton: Locator;
readonly errorMessage: Locator;
constructor(page: Page) {
this.page = page;
// Alle Locators im Konstruktor initialisieren
this.usernameInput = page.getByLabel('Username');
this.passwordInput = page.getByLabel('Password');
this.loginButton = page.getByRole('button', { name: 'Log in' });
this.errorMessage = page.getByTestId('login-error');
}
// Zur Anmeldeseite navigieren
async goto() {
await this.page.goto('/login');
}
// Anmeldevorgang ausführen
async login(username: string, password: string) {
await this.usernameInput.fill(username);
await this.passwordInput.fill(password);
await this.loginButton.click();
}
// Fehlermeldung für fehlgeschlagene Anmeldung überprüfen
async expectLoginError(message: string) {
await expect(this.errorMessage).toBeVisible();
await expect(this.errorMessage).toContainText(message);
}
}
Verwendung von Page Object in Tests
Beispiel
import { test, expect } from '@playwright/test';
import { LoginPage } from '../pages/LoginPage';
test.describe('Anmeldefunktionalität', () => {
test('Anmeldung ist mit korrektem Benutzernamen und Passwort erfolgreich', async ({ page }) => {
const loginPage = new LoginPage(page);
// Verwende die Methoden des Page Objects
await loginPage.goto();
await loginPage.login('example_user', 'correct_password');
// Überprüfe die Weiterleitung nach erfolgreicher Anmeldung
await expect(page).toHaveURL('/dashboard');
});
test('Login schlägt mit falschem Passwort fehl', async ({ page }) => {
const loginPage = new LoginPage(page);
await loginPage.goto();
await loginPage.login('example_user', 'wrong_password');
// Verwende die Assertion-Methoden des Page Objects
await loginPage.expectLoginError('Falscher Benutzername oder Passwort');
});
});
Mehrstufige Page Objects
In echten Projekten können Sie mehrere Page Objects erstellen, und diese können miteinander verknüpft werden.
Beispiel
import { type Page, type Locator, expect } from '@playwright/test';
export class DashboardPage {
readonly page: Page;
readonly welcomeText: Locator;
readonly logoutButton: Locator;
constructor(page: Page) {
this.page = page;
this.welcomeText = page.getByText('Willkommen zurück');
this.logoutButton = page.getByRole('button', { name: 'Abmelden' });
}
async expectWelcomeMessage(username: string) {
await expect(this.welcomeText).toContainText(username);
}
async logout() {
await this.logoutButton.click();
}
}
Page Objects kombinieren:
Beispiel
const loginPage = new LoginPage(page);
const dashboardPage = new DashboardPage(page);
// Anmelden
await loginPage.goto();
await loginPage.login('example_user', 'password');
// Dashboard überprüfen
await dashboardPage.expectWelcomeMessage('example_user');
// Abmelden
await dashboardPage.logout();
await expect(page).toHaveURL('/login');
});
Bewährte Praktiken für POM
| Übung | Beschreibung |
|---|---|
| Locators im Konstruktor zentralisieren | Definiere alle Locators im Konstruktor; erstelle sie nicht dynamisch in Methoden |
| Methoden geben Page Objects zurück | Operationsmethoden können ein neues Page Object zurückgeben (z. B. return DashboardPage nach dem Login) |
| Assertions kapseln, aber nicht übermäßig verwenden | Häufig verwendete Assertions-Kombinationen in Methoden kapseln; einfache Assertions direkt in den Tests schreiben |
| Komposition statt Vererbung verwenden | Tiefe Vererbung vermeiden; das Kompositionsmuster verwenden, um mehrere Page Objects zu verknüpfen |
| Ein Satz von Objekten deckt eine Seite/Komponente ab | Halten Sie die Granularität moderat; erstellen Sie nicht für jedes kleine Element eine separate Klasse |
Andere ErweiterungenPOM ist nicht verpflichtend.
Bei kleinen Projekten mit nur wenigen Tests ist es übersichtlicher, Locators direkt in den Tests zu schreiben. Wenn es mehr als 5 Testdateien gibt, sollten Sie die Einführung von POM in Betracht ziehen.