A TypeScript egy Microsoft által fejlesztett nyílt forráskódú, magas szintű programozási nyelv, amely a JavaScript szintaktikus felsőhalmaza (superset). Ez azt jelenti, hogy minden érvényes JavaScript kód egyben érvényes TypeScript kód is, viszont a TypeScript statikus típusosságot és fejlettebb fejlesztői eszközöket ad a nyelvhez.
A Playwright 1.64-es verziója számos olyan új funkciót és finomítást hozott, amelyek megkönnyítik az elemkeresést, a tesztek futtatását, valamint a videófelvételek testreszabását.
1. Új Locator API: locator.within()
A locator.within() segítségével két már létező locatort lehet természetes módon kombinálni, és a relatív pozicionálók (pl. .first(), .nth()) a szülő elemen belül értékelődnek ki.
TypeScript
// Összekapcsol két külön definíciótconstdialog=page.getByRole('dialog');constsaveButton=page.getByRole('button',{ name:'Mentés'});// Mentés gomb keresése kifejezetten a párbeszédablakon belülawaitsaveButton.within(dialog).click();
2. Véletlenszerű tesztfuttatás: --shuffle
Segít kiszűrni a tesztek közötti rejtett függőségeket a futtatási sorrend megkeverésével. A tesztfutás végén megadott seed kód segítségével pontosan reprodukálható a hibás futási sorrend.
Míg a 1.63-ban megjelent zárolások csak egyes tesztekre vonatkoztak, a 1.64-ben már egész fájlokra vagy tesztcsoportokra (describe) is alkalmazhatóak. Az azonos zárolási névvel rendelkező tesztek nem futnak párhuzamosan.
TypeScript
import {test} from '@playwright/test';// Az ebben a csoportban lévő tesztek nem futnak párhuzamosan más 'user-settings' zárral ellátott tesztekkeltest.describe.configure({ lock:'user-settings'});test('profil frissítése',async({page})=>{// ...});
4. default: false beállítás a projekt konfigurációban
A playwright.config.ts-ben megjelölhetők olyan böngészők vagy projektek, amelyeket alapértelmezetten ki szeretnél hagyni a sima npx playwright test futtatásból anélkül, meglévő konfigurációkat kellene törölni.
A Playwright kiegészült a böngésző alapú AI modellek eszközeinek (WebMCP) tesztelésére szolgáló felülettel (page.webmcp.tools() és page.webmcp.callTool()), amellyel ellenőrizhetők az oldalak által az AI-ágensek felé regisztrált eszközök.
Fontosabb breaking change-ek / Viselkedésbeli változások
Rejtett iframe-ek: A nem látható iframe-ben lévő elemeket (pl. visibility: hidden) a Playwright mostantól automatikusan rejtettként kezeli az akciók és a toBeVisible() ellenőrzések során.
Emulált képernyőméret: A devices['Desktop Chrome'] típusú eszközleírók átadják a screen tulajdonságot, így a window.screen felbontása és a media query-k az emulált kijelzőméretet tükrözik.
Snapshot frissítés: A --update-snapshots=missing opció használata esetén a hiányzó screenshotok létrehozása után a teszt sikeresként értékelődik.
Mennyi mindent használunk, de igazából lehet, hogy fogalmunk sincs róla, hogy mire is jó pontosan, és mikor is érdemes használni. A miértről nem is beszélve…
Mit mesél erről a Gemini?
A .NET-ben (C#) a yield kulcsszó pontosan ugyanazt a célt szolgálja, mint a Pythonban: IEnumerable<T> vagy IAsyncEnumerable<T> típusú adatfolyamokat hozhatsz vele létre úgy, hogy a kód lusta kiértékeléssel (lazy evaluation), elemenként adja vissza az eredményeket.
C#-ban két formája létezik:
yield return <érték>: Visszaad egy elemet, majd felfüggeszti a metódus futását a következő elem kéréséig.
yield break: Azonnal leállítja az iterációt (megszakítja a generálást).
Mire jó C#-ban?
1. Memóriatakarékosság nagy adathalmazoknál
Ha nem List<T>-et adsz vissza, nem kell a teljes gyűjteményt lefoglalni a RAM-ban.
C#
usingSystem;usingSystem.Collections.Generic;// PÉLDA 1: Hagyományos megközelítés (Memóriatakaréktalan)publicList<int>GetNumbersList(){varlist=newList<int>();for (inti=0;i<1_000_000;i++){list.Add(i);// Mind az 1 milló elem belekerül a RAM-ba}returnlist;}// PÉLDA 2: yield használata (Memóriatakarékos)publicIEnumerable<int>GetNumbersYield(){for (inti=0;i<1_000_000;i++){yieldreturni;// Mindig csak az aktuális számot generálja le}}
2. Szűrés és adatfeldolgozás yield break-kel
A yield break használatával feltételhez kötheted az adatfolyam végét anélkül, hogy bonyolult feltételkezelést kellene írnod a ciklus köré:
C#
publicIEnumerable<string>GetActiveUsers(List<string>users){foreach (varuserinusers){if (user=="ADMIN_STOP"){yieldbreak;// Azonnal leállítja az elemek kiadását}if (!string.IsNullOrEmpty(user)){yieldreturnuser;}}}
3. Óriási fájlok feldolgozása soronként
Nem kell a gigabájtos fájlokat egyszerre a memóriába tölteni (File.ReadAllLines helyett):
C#
usingSystem.IO;usingSystem.Collections.Generic;publicIEnumerable<string>ReadLargeFile(stringfilePath){using (StreamReaderreader=newStreamReader(filePath)){string?line;while ((line=reader.ReadLine()) !=null){ yield return line; // Mindig csak egyetlen sort tart a memóriában} }}// Használat:foreach (stringlineinReadLargeFile("huge_log.txt")){if(line.Contains("ERROR")){Console.WriteLine(line);}}
Modern .NET-ben hálózati kéréseknél vagy adatbázis-lekérdezéseknél aszinkron módon is használhatod:
C#
publicasyncIAsyncEnumerable<int>FetchDataAsync(){for (inti=1;i<=5;i++){awaitTask.Delay(1000);// Pl. hálózati várakozás szimulálásayieldreturni;}}// Használat:awaitforeach (variteminFetchDataAsync()){Console.WriteLine(item);// Másodpercenként jelenik meg egy elem}
Hagyományos visszatérés vs. yield C#-ban
Szempont
List<T> / Tömb
yield return (IEnumerable<T>)
Kiértékelés ideje
Azonnali (A metódus hívásakor lefut a teljes ciklus)
Lusta / Halasztott (Csak akkor fut, amikor a foreach kéri a következő elemet)
Igen, pontosan ugyanígy működik TypeScriptben és JavaScriptben is.
A TypeScript a JavaScript generátor függvényeit (Generator Functions) használja, amelyeket az function* (csillaggal jelölt) szintaxisról lehet felismerni.
A működési elv teljesen megegyezik a Python és a C# esetében látottakkal: a yield felfüggeszti a függvény futását, megőrzi a belső állapotot, és lusta kiértékeléssel (lazy evaluation) adja vissza az elemeket egy Generator objektumon keresztül.
Alapvető példa TypeScriptben
A generátor függvény visszatérési típusa Generator<T, TNext TReturn,>, ahol a T a yield-elt értékek típusa.
TypeScript
// A csillag (function*) jelzi, hogy ez egy generátor függvényfunction*szamGeneraltor():Generator<number>{yield1;yield2;yield3;}// Használat for...of ciklussal:for (constszamofszamGeneraltor()) {console.log(szam);// Kiírja egymás után: 1, 2, 3}
A TypeScriptben létezik a yield* utasítás is, amellyel átadhatod a vezérlést egy másik generátornak vagy tömbnek (bejárható objektumnak):
TypeScript
function*elsoResz():Generator<number>{yield1;yield2;}function*teljesSorozat():Generator<number>{yield*elsoResz();// Delegálja az elemeket az elsoResz-bőlyield* [3,4,5];// Tömb elemeit is ki tudja adni egymás után}console.log([...teljesSorozat()]);// [1, 2, 3, 4, 5]
3. Aszinkron generátorok (yield + async)
Ahogy C#-ban az IAsyncEnumerable, TypeScriptben és JS-ben is létezik az AsyncGenerator (async function*). Ez hálózati adatok, lapozott API-k vagy adatfolyamok (stream) feldolgozásánál nagyon hasznos:
TypeScript
asyncfunction*adatokLetolteseAPIrol():AsyncGenerator<string>{constoldalak= [1,2,3];for (constoldalofoldalak) {// Szimulált hálózati kérés (API hívás)constvalasz=awaitfetch(`https://api.example.com/data?page=${oldal}`);constadat=awaitvalasz.text();yieldadat;// Mindig csak az aktuális oldal adatait adja vissza}}// Használat for await...of ciklussal:asyncfunctionfeldolgozas(){forawait (constoldalAdatofadatokLetolteseAPIrol()) {console.log("Megérkezett egy oldal:",oldalAdat);}}
Hol is kezdjem? Ma is elégettem nem kevés tokent, bár szerencsére ezek ingyen vannak/voltak. Amit ki akartam próbálni, hogy telepítettem egy Rider-t, ami egy IDE, és nekem a .net miatt van rá szükség, majd pedig a Copilot-tal és Gemini-vel elkezdtem ebből egy Playwright, Nunit és .net projectet faragni. Aztán jött a szokásos nehézség, kell egy jelentést generáló eszköz, ami többet vagy épp másképpen tud, mint az Allure. Az AI azt mondta, hogy Report Portal.
Nem volt mit tenni, elkezdtem belefaragni ezt, és az API kulcs generáláson kívül minden lépést az AI CLI-on keresztül csináltam meg. Szerintem elég pofás lett a végeredmény, de majd erről egy másik bejegyzésben írok részletesebben.
Most inkább megmutatom, hogy mit tud a Report Portal.
Mit mond a Gemini?
A ReportPortal egy nyílt forráskódú (Open Source), AI-alapú tesztriportáló és analitikai platform. Elsősorban automatizált tesztek eredményeinek gyűjtésére, vizualizálására és elemzésére szolgál.
Főbb jellemzők és előnyök
Központi dashboard: Egységes felületen gyűjti össze a különböző tesztkeretrendszerekből és CI/CD csatornákból származó teszteredményeket.
AI / Machine Learning alapú hibaelemzés: A korábbi futtatások alapján automatikusan felcímkézi a hibákat (pl. termékhiba, teszthiba, infrastruktúra-probléma), így drasztikusan csökkenti a manuális triázsolásra fordított időt.
Valós idejű analitika: A tesztek futása közben élőben láthatók az eredmények, trendek és statisztikák.
Integrációk: Szorosan együttműködik hibakövető rendszerekkel (Jira, Rally, Redmine) és CI/CD eszközökkel (Jenkins, GitLab CI, GitHub Actions).
A ReportPortal architektúrája
A ReportPortal mikroszolgáltatás-alapú architektúrát használ, amely több konténerből áll (API Service, UI, Index Service/AI Engine, PostgreSQL, RabbitMQ, OpenSearch/Elasticsearch). Ezért a legegyszerűbb és legajánlottabb módja a lokális futtatásnak a Docker / Docker Compose.
Mi is történt? Ismét a semmiből kezdtem, megkértem a Copilot-ot, hogy csináljon egy project-et. El is készült, futott, de a riportolásával nem voltam elégedett. Megkérdeztem, hogy mit ajánl rá, ő elsőre a Grafana felhős szolgáltatását ajánlotta, de mivel lokálból akartam megoldani, így kiegyeztünk a Grafana lokális verziójával. Telepített Grafanát, Dockert, InfluxDB-t. Még a Grafana dashboard-ot is vele csináltattam meg. Még koránt sincs kész, de majd megfelelő Token birtoklásával orvosolni fogom.
Teszt kód:
import http from 'k6/http';import {check,sleep} from 'k6';exportconstoptions={ stages: [{ duration:'40s', target:2},{ duration:'35s', target:10},{ duration:'60s', target:3}, ], thresholds:{ http_req_failed: ['rate<0.01'], http_req_duration: ['p(95)<500'],},};constbaseUrl=__ENV.BASE_URL||'https://test.k6.io';export default function (){ const response = http.get(baseUrl);check(response,{'status is 200':(result) => result.status === 200,'response is HTML':(result) => result.headers['Content-Type'].includes('text/html'),});}
Megkésve, de törve nem, én is elkezdtem egyre több dologra használni az AI-t, ahogy az a korábbi bejegyzéseimből is látszik. Reggel gondoltam egy merészet, és megkértem a Copilot-ot, hogy kezdjünk el csinálni egy Playwright, TypeScript projectet, mindezt VSCode-ban, és csak CLI-jal. Meg kell mondjam, egész jól sikerültek az alapok, és időben is lényegesen hamarabb készült el, mintsem, ha kézzel kezdem el.
Felbuzdulva ezen, megkértem, hogy integrálja bele az Allure riport készítést, ami elsőre nem volt teljes siker, mert nem tartalmazta a korábbi futásokat a kérésem ellenére, de ez is hamar javítva lett.
Folytattam azzal, hogy egy ingyenes és publikus API hívásra írattam vele 3 tesztet, majd pedig kértem, hogy legyen 2 negatív is, amit ő elsőre úgy értett, hogy átírta a meglévőket. Ezt is hamar javítottuk.
Kértem, hogy amit csináltunk, azt tegye bele egy Word fájlba, illetve még készítettem vele egy readme.md fájlt is. Szerintem egész jól sikerült, mindezt relatív kevés idő alatt, szóval biztosan fogom még folytatni vele a munkát.
Íme a teljes lista:
Project path: D:\Repositories\ai-playwright Earliest retrievable project record: approximately 08:55 local time (06:55 UTC)
08:53 ? Initial workspace session
Opened the working area under D:\Repositories.
08:55 ? Created the Playwright project
Created D:\Repositories\ai-playwright as a TypeScript Playwright project.
Configured Chromium, added example tests and a GitHub Actions workflow.
Installed dependencies and Chromium.
Verified that the two starter tests passed with npx playwright test.
09:01 ? Changed reporting to Allure
Switched the default Playwright reporter to Allure.
Added Allure report generation and execution-history persistence.
Updated package.json, playwright.config.ts, .github/workflows/playwright.yml, .gitignore, and scripts/allure-history.js.
Configured CI to restore and save Allure history.
Verified the initial tests and report generation.
09:07?09:23 ? Opened and fixed Allure history
Generated allure-report and started it with npm run allure:open.
Investigated why previous executions were not visible.
Fixed the issue by clearing old result files before each run while preserving history.
Verified that the report showed three executions per test instead of treating earlier executions as retries.
09:26 ? Added Open-Meteo API tests
Added tests in tests/open-meteo-api.spec.ts.
Covered a valid forecast request, invalid latitude, and invalid longitude.
All three tests passed.
09:28?09:34 ? Regenerated the report and improved assertions
Regenerated Allure with the API tests.
Added descriptive failure messages to the expect assertions.
09:49?09:51 ? Added more negative API scenarios
Added a request missing required longitude.
Added a request with an unsupported current-weather variable.
The API test file reached five tests total.
09:52 ? Verified all tests
Ran the full suite.
All seven tests passed.
Regenerated the Allure report with all tests.
09:55?10:03 ? Fixed Allure generation in GitHub Actions
Investigated why the report was not generated in CI.
Updated the workflow to restore history, run Playwright, always generate the report, and upload the report artifact when possible.
Local verification passed.
10:07?10:12 ? Discussed opening reports from CI
Clarified that GitHub Actions cannot directly open a browser on the runner.
Discussed GitHub Pages as the way to automatically host and view the report.
Explained how to open a downloaded report locally with npx allure open.
10:20 ? Opened the Allure report again
10:31 ? Added Playwright Codegen
Added the codegen script to package.json.
Usage: npm run codegen — https://example.com.
Discussed saving recorded tests with –output tests/recorded.spec.ts.
10:34?10:48 ? Reviewed the project and exported coverage
Explained that the project is a Playwright test project, not the application under test.
Identified that baseURL and webServer are not configured.
Created D:\Repositories\ai-playwright\test-coverage.xlsx.
The workbook contains all seven test cases, behaviors, assertions, Allure statuses, and a test-scope coverage summary.
Note: The earliest project-creation record available is the summarized 08:55 local-time session; the initial setup session does not contain a complete message-by-message transcript.
10:56 – Added project README documentation
Created README.md in the project root.
Documented prerequisites and installation from scratch.
Documented browser and API test execution.
Documented Allure report generation, opening, and execution-history handling.
Documented Playwright Codegen usage.
Documented project configuration, structure, GitHub Actions CI behavior, and troubleshooting.
Mire jó az AI? Hát például arra, hogy ha írni szeretnék egy témáról, de lusta vagyok, az egyébként is Google segítsével összeszedett információkat rendszerbe szedni, akkor relatív gyorsan kézhez kapok egy bejegyzést.
A Page Object Model (POM) a szoftvertesztelés-automatizálás egyik legnépszerűbb és leghatékonyabb tervezési mintája (Design Pattern). A lényege, hogy az alkalmazás egyes weboldalait (vagy oldalrészeit) különálló objektumokként képezi le a kód szintjén.
Miért érdemes használni?
Karbantarthatóság: Ha megváltozik egy gomb ID-ja vagy egy mező elhelyezkedése, elegendő azt egyetlen helyen (a Page Object osztályban) átírni, a teszteseteket nem kell bántani.
Kód újrafelhasználhatósága: A gyakori műveletek (pl. bejelentkezés, keresés) egyszer vannak megírva, és bármelyik tesztből meghívhatók.
Olvashatóság: A tesztkód tiszta, átlátható és üzleti logikát követő lesz, rejtve a techniai megvalósítást (pl. DOM-lekérdezéseket).
Minta megvalósítás (Python + Selenium)
Az alábbiakban egy klasszikus bejelentkezési folyamat példáján keresztül látható a POM működése.
A Page Object osztály (login_page.py)
Ez az osztály tartalmazza az oldal elemeinek azonosítóit (lokátorait) és a végezhető műveleteket.
Python
from selenium.webdriver.common.by import ByclassLoginPage:def__init__(self,driver):self.driver = driver# Lokátorok (különválasztva a logikától)self._username_input =(By.ID,"username")self._password_input =(By.ID,"password")self._login_button =(By.CSS_SELECTOR,"button[type='submit']")self._error_message =(By.CLASS_NAME,"flash-error")# Akciók / Műveletekdefenter_username(self,username:str):self.driver.find_element(*self._username_input).send_keys(username)defenter_password(self,password:str):self.driver.find_element(*self._password_input).send_keys(password)defclick_login(self):self.driver.find_element(*self._login_button).click()# Összetett folyamat (Láncolt / Magasabb szintű akció)deflogin(self,username:str,password:str):self.enter_username(username)self.enter_password(password)self.click_login()defget_error_message(self)->str:returnself.driver.find_element(*self._error_message).text
A Teszteset (test_login.py)
A tesztkód csak a Page Object által nyújtott metódusokat használja, így végtelenül egyszerű és olvasható.
Ne tegyél assertion-öket a Page Object-be: A assert kifejezések a tesztfájlban maradjanak, a Page Object csak adatot adjon vissza vagy állapotot módosítson.
Page Factory használata: Bizonyos keretrendszerekben (pl. Java + Selenium) a @FindBy annotációkkal még tisztább szerkezet érhető el.
Lazy loading: Az elemeket csak akkor kérd le a DOM-ból, amikor ténylegesen szükség van rájuk (például dinamikus felületek esetén).
A Page Object Model (POM) megvalósítása a modernebb eszközökkel (mint a Playwright vagy a Selenium Java-alapú változata) még letisztultabbá válik, mivel ezek a keretrendszerek beépített architektúrával támogatják a megbízhatóbb elemkezelést.
Az alábbiakban mindkét megközelítésre találsz egy-egy komplett kódmintát.
Playwright + TypeScript (Ajánlott / Modern megközelítés)
A Playwright eleve magában foglalja az automatikus várakozást (Auto-waiting), így nincs szükség explicit wait-ek kézi kezelésére.
A Page Object osztály (pages/LoginPage.ts)
TypeScript
import {Page,Locator} from '@playwright/test';exportclassLoginPage{readonlypage:Page;readonlyusernameInput:Locator;readonlypasswordInput:Locator;readonlyloginButton:Locator;readonlyerrorMessage:Locator;constructor(page:Page){self.page=page;// A Playwright-ban a lokátorok deklaratívak, nem kérdezik le azonnal a DOM-otthis.usernameInput=page.locator('#username');this.passwordInput=page.locator('#password');this.loginButton=page.locator('button[type="submit"]');this.errorMessage=page.locator('.flash-error');}asyncgoto(){awaitthis.page.goto('https://example.com/login');}asynclogin(username:string,password:string){awaitthis.usernameInput.fill(username);awaitthis.passwordInput.fill(password);awaitthis.loginButton.click();}asyncgetErrorMessage():Promise<string>{returnawaitthis.errorMessage.textContent() ||'';}}
A Tesztfájl (tests/login.spec.ts)
TypeScript
import {test,expect} from '@playwright/test';import {LoginPage} from '../pages/LoginPage';test.describe('Bejelentkezés tesztek',()=>{letloginPage:LoginPage;test.beforeEach(async({page})=>{loginPage=newLoginPage(page);awaitloginPage.goto();});test('Sikeres bejelentkezés',async({page})=>{awaitloginPage.login('valid_user','correct_password');// Ellenőrzés Playwright assert-telawaitexpect(page).toHaveURL('https://example.com/dashboard');});test('Hibás bejelentkezés',async()=>{awaitloginPage.login('invalid_user','wrong_password');awaitexpect(loginPage.errorMessage).toBeVisible();awaitexpect(loginPage.errorMessage).toContainText('Érvénytelen adatok');});});
Java + Selenium (Klasszikus keretrendszer)
Java környezetben a PageFactory és a @FindBy annotációk használata a legelterjedtebb POM minta.
A @FindBy elemek lekezeléséhez várakozás (WebDriverWait) kellhet
Párhuzamosítás
Alapból támogatott a tesztfutztatóban
TestNG vagy JUnit szálkezelést igényel
Inicializálás
Egyszerű objektumkonstruktor
PageFactory.initElements() hívás szükséges
A Playwright Custom Fixture funkciója segítségével a Page Object osztályok példányosítását teljesen kiszervezheted a tesztekből. Ezzel elkerülhető, hogy minden egyes tesztfájlban manuálisan kelljen megadni a const loginPage = new LoginPage(page) sorokat.
A tesztek így közvetlenül paraméterként kérhetik el a szükséges oldalobjektumokat, az infrastruktúra pedig automatikusan példányosítja és előkészíti azokat.
A Page Object osztályok (pages/)
A megszokott módon hozzuk létre az oldalklasszokat.
TypeScript
// pages/LoginPage.tsimport {Page,Locator} from '@playwright/test';exportclassLoginPage{readonlypage:Page;readonlyusernameInput:Locator;constructor(page:Page){this.page=page;this.usernameInput=page.locator('#username');}asyncgoto(){awaitthis.page.goto('/login');}}// pages/DashboardPage.tsimport {Page,Locator} from '@playwright/test';exportclassDashboardPage{readonlypage:Page;readonlyuserMenu:Locator;constructor(page:Page){this.page=page;this.userMenu=page.locator('#user-menu');}}
A Custom Fixture létrehozása (fixtures/baseTest.ts)
Itt terjesztjük ki a Playwright alapértelmezett test objektumát, megadva a saját Page Object fixture-jeinket.
TypeScript
import {test as base} from '@playwright/test';import {LoginPage} from '../pages/LoginPage';import {DashboardPage} from '../pages/DashboardPage';// 1. Típusdefiníció a fixture-ökhöztypeMyFixtures={loginPage:LoginPage;dashboardPage:DashboardPage;};// 2. A 'base.extend' használatával regisztráljuk a saját fixture-jeinketexportconsttest=base.extend<MyFixtures>({// Automatikusan példányosítja a LoginPage-t és igény esetén megnyitja az oldaltloginPage:async({page},use)=>{constloginPage=newLoginPage(page);awaitloginPage.goto();// Akár előkészítő lépéseket is tehetünk ideawaituse(loginPage);// Átadja az objektumot a tesztnek},// Példányosítja a DashboardPage-tdashboardPage:async({page},use)=>{constdashboardPage=newDashboardPage(page);awaituse(dashboardPage);},});// Az 'expect'-et is exportáljuk a kényelmes importálásértexport {expect} from '@playwright/test';
A Fixture-ök használata a tesztekben (tests/login.spec.ts)
A @playwright/test helyett a saját fixtures/baseTest fájlunkból importáljuk a test objektumot. A tesztfüggvény paramétereként megadott nevek alapján a Playwright automatikusan beadagolja a megfelelő példányokat.
TypeScript
// Figyelem: A saját kiterjesztett test objektumunkat importáljuk!import {test,expect} from '../fixtures/baseTest';test('Sikeres bejelentkezés custom fixture-rel',async({loginPage,dashboardPage})=>{// A loginPage.goto() már lefutott a fixture-ben!awaitloginPage.usernameInput.fill('standard_user');// A dashboardPage is azonnal használható, nem kellett 'new'-val példányosítaniawaitexpect(dashboardPage.userMenu).toBeVisible();});
Miért ez a legnépszerűbb Playwright architektúra?
Nulla boilerplate kód: Nem kell beforeEach blokkokban példányosítani az osztályokat.
Lazy loading (Lusta betöltés): Csak azok a Page Object-ek példányosulnak, amiket a teszt fejlécében ({ loginPage, dashboardPage }) kifejezetten elkérsz.
Beépített tear-down: A fixture-ben a use() hívás utáni kódrészlet automatikusan lefut a teszt végén (takarításra, kijelentkezésre ideális).
A Playwright 1.63 frissítése megérkezett, és számtalan olyan funkciót hoz, amelyek lényegesen egyszerűbbé teszik a komplex tesztelési munkafolyamatokat, a párhuzamosítást és a hibakeresést.
Az alábbiakban összefoglaltuk a kiadás legfontosabb újdonságait és fejlesztéseit.
Key Features & Újdonságok
1. Test Locks (Tesztreteszek)
Megoldást nyújt a közös erőforrások (pl. központi adatbázis, globális fiókbeállítások vagy külső API-k) használata miatti ütközésekre.
Lehetővé teszi zárolások (locks) megadását, így a tesztek automatikusan sorba állnak a kritikus erőforrások eléréséhez, elkerülve a párhuzamos futtatásból eredő hibákat.
2. Step paraméterek és feliratok (test.step)
A test.step() mostantól elfogad egy params opciót, amellyel saját metaadatokat és paramétereket adhatsz át a lépésekhez.
A riportokban és a Trace Viewerben tisztábban nyomon követhetők az egyedi lépésekhez tartozó változók és hívási argumentumok.
3. Aria Traces & Bővített Tracing
A Trace Viewer új aria pillanatképeket (snapshots) támogat.
Megkönnyíti a hozzáférhetőségi (accessibility) elemek és az ARIA fa állapotának elemzését hibakeresés közben.
4. Új Scroll Opciók az akcióknál
A legtöbb akciónál (pl. .click()) megjelent egy új scroll opció ("auto" | "none").
Lehetőséget biztosít arra, hogy kikapcsold a Playwright automatikus „scroll-into-view” viselkedését, ha egy elem pozícióját manuálisan szeretnéd kezelni.
5. Új teszt opciók és CLI parancsok
Nagyobb hozzáférhetőség tesztelése: Új reducedMotion, forcedColors és contrast opciók a testOptions alatt.
--add-reporter parancssori opció: Bővítheted a meglévő riporterek listáját ahelyett, hogy felülírnád a playwright.config.ts-ben megadottakat.
omitTags opció: Letisztultabb tesztcímek a riportokban (suppress-eli az automatikusan hozzáfűzött tegeket a list, line, dot, github és junit riportereknél).
Eltávolított (Deprecated) API-k
A 1.63-as verzió végleg kivezeti a régen elavultnak jelölt funkciókat:
Locator.ariaRef() (használd helyette a locator.ariaSnapshot() funkciót).
handle opció a BrowserContext.exposeBinding és Page.exposeBinding esetében.
logger opció a BrowserType.connect és connectOverCDP metódusoknál.
videosPath és videoSize konfig opciók (használd a recordVideo-t).
Frissítés
A legújabb verzióra való átálláshoz futtasd a projekt gyökerében az alábbi parancsot:
A Playwright 1.63-ban megjelent Test Locks (Tesztreteszek) opció segítségével megakadályozhatod, hogy bizonyos tesztek egyszerre futjanak és ütközzenek a közös erőforrásokon (pl. ugyanazon tesztfiók beállításai, adatbázis vagy külső API-k), miközben a többi független teszt továbbra is párhuzamosan fut.
Az alábbiakban bemutatjuk a legfontosabb használati módokat kódpéldákkal.
1. Egyedi teszt zárolása egy megnevezett retesszel (lock)
Ha van két vagy több teszted, amelyek ugyanazt a megosztott erőforrást módosítják, megadhatsz nekik egy azonos lock nevet az opciók között:
TypeScript
import {test,expect} from '@playwright/test';// Ez a teszt lefoglalja az 'admin-account' reteszttest('Adminisztrátor frissíti a cég nevét',{ lock:'admin-account'},async({page})=>{awaitpage.goto('https://example.com/admin/settings');awaitpage.getByLabel('Cégnév').fill('Új Cégnév Kft.');awaitpage.getByRole('button',{ name:'Mentés'}).click();awaitexpect(page.getByText('Sikeres mentés')).toBeVisible();});// Ez a teszt megvárja, amíg az előző teszt elengedi az 'admin-account' reteszttest('Adminisztrátor módosítja az időzónát',{ lock:'admin-account'},async({page})=>{awaitpage.goto('https://example.com/admin/settings');awaitpage.getByLabel('Időzóna').selectOption('Europe/Budapest');awaitpage.getByRole('button',{ name:'Mentés'}).click();awaitexpect(page.getByText('Sikeres mentés')).toBeVisible();});
Hogyan működik? Amíg a Worker 1 az első tesztet futtatja az admin-account retesszel, addig a Worker 2 nem kezdi el a második tesztet. A két teszt egymás után fog lefutni, de a csomag többi, független tesztje (pl. termékkeresés, kosárkezelés) továbbra is teljesen párhuzamosan fut a többi workeren.
2. Egész tesztcsoport zárolása (test.describe)
Ha egy egész blokknyi teszt egyetlen közös erőforráson dolgozik, a lock opciót közvetlenül a test.describe() csoportra is ráteheted:
TypeScript
import {test,expect} from '@playwright/test';test.describe('Adatbázis konfigurációs tesztek',{ lock:'database-config'},()=>{test('Alapértelmezett nyelv beállítása',async({page})=>{// ... teszt kód});test('Rendszerértesítések kikapcsolása',async({page})=>{// ... teszt kód});});
3. Több retesz egyidejű használata (Array)
Egy teszt akár több megosztott erőforrás zárolását is kérheti egyszerre. Ehhez adj meg egy tömböt a lock paraméterben:
TypeScript
import {test,expect} from '@playwright/test';test('Fizetési átjáró és szállítási beállítások egyidejű frissítése',{ lock: ['payment-sandbox','shipping-api'] },async({page})=>{// Ez a teszt csak akkor indul el, ha mindkét retesz szabadawaitpage.goto('https://example.com/admin/integrations');// ... teszt kód});
Bár nagyon sokat használtam, mégsincs kéznél egy darab példakódom sem ezzel kapcsolatban. Így hát a Playwright bibliát fogom segítségül hozni a példák bemutatására.
Mire való?
Nekem ez akkor volt nagyon hasznos, amikor API teszteket írtam, és a GET endpoint válaszánál nem volt elég egy 200-as válaszkód, mivel a háttérben a szinkronizációs folyamat nem ért be, tehát a GET endpoint-ot addig kellett hívni, amíg a megfelelő válasz meg nem érkezett.
Elsőre én is, mint egy kis cserkész, betettem egy while loop-ba, és működött tökéletesen. Aztán rátaláltam a Playwright által támogatott gyári megoldásra, és azt kell mondanom, hogy zseniálisan jól működőtt.
awaitexpect.poll(async()=>{constresponse=awaitpage.request.get('https://api.example.com');returnresponse.status();},{// Custom expect message for reporting, optional. message:'make sure API eventually succeeds',// Poll for 10 seconds; defaults to 5 seconds. Pass 0 to disable timeout. timeout:10000,}).toBe(200);
Mi is történik itt? A GET endpoint válaszkódjával térünk vissza, és azt hasonlítjük össze az elvárttal. Teszük ezt addig, amíg tart a timeout-ban megadott érték.
Ekkor az intervals-ban megadott értékek fogják jelenteni a próbálkozások közt eltelt időt. Ezt érdemes úgy beállítani, hogy lehetőleg ne generáljuk túl nagy extra terhelést a rendszer számára.
Az expect.soft kapcsán nekem az a megélésem, hogy nagyon megoszlanak a vélemények. Vannak, akik teljes mértékben ellenzik a használatát, mások pedig – mint én is – úgy vannak vele, hogy vannak olyan esetek, amikor szükséges lehet. Ugye, soft esetén ha hibára fut, nem áll meg a futás, hanem megy tovább a teszt.