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

VorteilBeschreibung
Vereinfacht das TestschreibenTestcode 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 LesbarkeitTestcode liest sich eher wie eine Fachsprache und ist dadurch auch für nicht-technische Personen verständlich
Vermeidet DuplikateDie 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

// Dateipfad: pages/LoginPage.ts
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

// Dateipfad: tests/login.spec.ts
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

// Dateipfad: pages/DashboardPage.ts
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

test('Vollständiger Login- und Logout-Ablauf', async ({ page }) => {
  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

ÜbungBeschreibung
Locators im Konstruktor zentralisierenDefiniere alle Locators im Konstruktor; erstelle sie nicht dynamisch in Methoden
Methoden geben Page Objects zurückOperationsmethoden können ein neues Page Object zurückgeben (z. B. return DashboardPage nach dem Login)
Assertions kapseln, aber nicht übermäßig verwendenHäufig verwendete Assertions-Kombinationen in Methoden kapseln; einfache Assertions direkt in den Tests schreiben
Komposition statt Vererbung verwendenTiefe Vererbung vermeiden; das Kompositionsmuster verwenden, um mehrere Page Objects zu verknüpfen
Ein Satz von Objekten deckt eine Seite/Komponente abHalten Sie die Granularität moderat; erstellen Sie nicht für jedes kleine Element eine separate Klasse

POM 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.

Andere Erweiterungen