Powrót do: Praktyczne wprowadzenie do testów automatycznych z Playwright
Adnotacje i oznaczenia testów w Playwright
Prezentacja
Dodatkowe materiały
Cały kod potrzeby do realizacji tematów z tej lekcji znajdziesz też w naszym repozytorium: playwright_automatyzacja_wprowadzenie.
A dokładniej bazujemy na projekcie, który znajdziesz w katalogu S04 / L03_nowe_tagi.
Adnotacje to specjalne oznaczenia, które dodajemy do testów. Możesz sobie wyobrazić adnotacje jako rodzaj notatek lub instrukcji przyczepionych do kodu. Notatki te nie wpływają bezpośrednio na to, jak działa nasz kod. Jednak są bardzo przydatne w organizacji i poprawie czytelności naszego kodu i testów.
Adnotacje w Playwright to specjalne oznaczenia, które dodajesz do testów. Możesz użyć adnotacji, aby oznaczyć testy jako pomijane, nieudane, zbyt wolne, lub skupić się na konkretnym teście. Adnotacje mogą również zawierać dodatkowe informacje, takie jak powiązania z konkretnymi problemami (poprzez URL) czy kategorie.
Adnotacje w testach
Test bez adnotacji:
test('successful login with correct credentials', async ({ page }) => { // Arrange const userId = loginData.userId; const userPassword = loginData.userPassword; const expectedUserName = 'Jan Demobankowy'; // Act await loginPage.login(userId, userPassword); // Assert const pulpitPage = new PulpitPage(page); await expect(pulpitPage.userNameText).toHaveText(expectedUserName); } );
Test z adnotacją:
test('successful login with correct credentials', { tag: ['@smoke', '@login'], annotation: { type: 'happy path', description: 'Basic happy path test' }, }, async ({ page }) => { // Arrange const userId = loginData.userId; const userPassword = loginData.userPassword; const expectedUserName = 'Jan Demobankowy'; // Act await loginPage.login(userId, userPassword); // Assert const pulpitPage = new PulpitPage(page); await expect(pulpitPage.userNameText).toHaveText(expectedUserName); } );
Obiekt konfiguracji składa się z 2 pól – type oraz description:
{ type: 'happy path', description: 'Basic happy path test' },
Test z wieloma adnotacjami:
test('successful login with correct credentials', { tag: ['@smoke', '@login'], annotation: [ { type: 'happy path', description: 'Basic happy path test' }, { type: 'documentation', description: 'https://playwright.info/' } ], }, async ({ page }) => { // Arrange const userId = loginData.userId; const userPassword = loginData.userPassword; const expectedUserName = 'Jan Demobankowy'; // Act await loginPage.login(userId, userPassword); // Assert const pulpitPage = new PulpitPage(page); await expect(pulpitPage.userNameText).toHaveText(expectedUserName); } );
Linki
- Oficjalna dokuemntacja o adnotacjach w Playwright
- Kilka przykładów adnotacji, które opisalismy na naszym blogu playwright.info – Co nowego w Playwright 1.42 – praktyczne przykłady!
Cześć,
Pewnie już wiecie, ale w Playwright link nawet z tekstem przed jest klikalny. Przynajmniej w wersji 1.47.2
Zgadza się! 😁
Jest to fajne ułatwienie/usprawnienie zarówno po stronie testów, jak i z poziomu raportów po testach 😉