Adnotacje i oznaczenia testów w Playwright

Powrót do: Praktyczne wprowadzenie do testów automatycznych z Playwright

Adnotacje i oznaczenia testów w Playwright

Prezentacja

Dodatkowe materiały

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!