Rövid útmutató: Speciális diagnosztika elvégzése a Playwright Workspaces jelentéseivel.

Ebben a rövid útmutatóban megtudhatja, hogyan végezheti el a Playwright-tesztek hibakeresését a Playwright-munkaterületek jelentéskészítési funkciójával. Speciális diagnosztikát végezhet a Playwright-teszteken. Ehhez mentse a tesztjelentéseket az Azure Storage-ba, és tekintse meg őket az Azure Portalon a Playwright Workspaces riporterével.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha nincs Azure-előfizetésed, hozz létre egy ingyenes fiókot mielőtt elkezdenéd.
• Az Azure-fiókhoz tulajdonosi, közreműködői vagy klasszikus rendszergazdai szerepkörre van szükség.
• Playwright-projekt, amely Playwright-futót és JavaScript SDK-t használ (az NUnit és más futók jelenleg nem támogatottak). Ha nem rendelkezik projektel, hozzon létre egyet a Playwright első lépések dokumentációjában , vagy használja a Playwright Workspaces mintaprojektet.
• A Playwright-projektnek a Playwright-csomag (@plawright/teszt) 1.57-es vagy újabb verzióját kell használnia.
• Azure parancssori felület (CLI). Ha nem rendelkezik Azure CLI-vel, tekintse meg az Azure CLI telepítését.
• A Playwright-munkaterületnek Microsoft Entra-azonosító hitelesítést kell használnia. A jelentéskészítéshez nem támogatott a hozzáférési jogkivonatot használó hitelesítés.

Jelentéskészítés engedélyezése és tárfiók munkaterülethez csatolása

A Playwright-munkaterületek jelentéskészítésének első lépése a jelentéskészítés engedélyezése a munkaterületen, és egy tárfiók összekapcsolása a jelentéskészítési összetevők tárolásához. Első lépésként használhatja az új munkaterületet, vagy használhatja a meglévő munkaterületet.

Új munkaterület

1. Jelentkezzen be az Azure Portalra az Azure-előfizetés hitelesítő adataival.

2. A portál kezdőlapján keresse meg és válassza az Azure App Testing lehetőséget.

   

3. Az Azure App Testing Hubon válassza a Létrehozás lehetőséget a Playwright-munkaterületek alatt

   

4. A Playwright-munkaterület erőforráslapján adja meg a következő információkat:

   szakterület	Description
   Subscription	Válassza ki a Playwright-munkaterülethez használni kívánt Azure-előfizetést.
   Erőforráscsoport	Válasszon ki egy meglévő erőforráscsoportot. Vagy válassza az Új létrehozása lehetőséget, majd adjon meg egy egyedi nevet az új erőforráscsoportnak.
   Név	Adjon meg egy egyedi nevet a munkaterületnek. A név csak alfanumerikus karakterekből és kötőjelekből állhat, és hossza 3 és 24 karakter között lehet.
   Location	Válassza ki a munkaterület földrajzi helyét. Ez a hely határozza meg a teszt végrehajtási eredményeinek tárolási helyét is.
   Jelentéskészítés	A kapcsoló alapértelmezés szerint engedélyezve van, így a felhasználók menthetik és megtekinthetik a tesztfuttatási jelentéseiket a Playwright Workspace-ből. Ha ki szeretné kapcsolni a jelentéskészítést, állítsa a beállítást Letiltva értékre.
   tárhelyfiók	A kapcsoló alapértelmezés szerint engedélyezve van, így a felhasználók menthetik és megtekinthetik a tesztfuttatási jelentéseiket a Playwright Workspace-ből. Ha ki szeretné kapcsolni a jelentéskészítést, állítsa a beállítást Letiltva értékre.

   Megjegyzés:

   A Playwright Workspaces jelentéskészítése az Azure Storage használatával tárolja a tesztjelentéseket és más összetevőket. A tárolási költségeket a tárfiók adatmegőrzési beállításai alapján határozzuk meg.

   Megjegyzés:

   Igény szerint további részleteket is konfigurálhat a Címkék lapon. A címkék név-érték párok, amelyek lehetővé teszik az erőforrások kategorizálását és az összevont számlázás megtekintését úgy, hogy ugyanazt a címkét több erőforrásra és erőforráscsoportra alkalmazza.

5. Miután befejezte az erőforrás konfigurálását, válassza a Véleményezés + Létrehozás lehetőséget.

6. Tekintse át a megadott beállításokat, majd kattintson a Létrehozás-ra. A munkaterület létrehozása néhány percet vesz igénybe. Mielőtt továbblépne, várja meg, amíg a portáloldal megjelenik Az üzembe helyezés befejeződött .

   

Meglévő munkaterület

1. Jelentkezzen be az Azure Portalra az Azure-előfizetés hitelesítő adataival.

2. A portál kezdőlapján keresse meg és válassza az Azure App Testing lehetőséget.

   

3. Az Azure App Testing Hubon válassza az Erőforrások megtekintése lehetőséget.

   

4. Keresse meg és nyissa meg a Playwright-munkaterületet.

5. A bal oldali navigációs sávon válassza a Beállítások –> Tárolókonfiguráció lehetőséget.

6. Állítsa a Jelentéskészítés kapcsolót Engedélyezve értékre, és válasszon ki egy tárfiókot a Playwright-munkaterületre való hivatkozáshoz.

   

   Megjegyzés:

   A Playwright Workspaces jelentéskészítése az Azure Storage használatával tárolja a tesztjelentéseket és más összetevőket. A tárolási költségeket a tárfiók adatmegőrzési beállításai alapján határozzuk meg.

7. Válassza az Mentésgombot.

Szerepköralapú hozzáférés-vezérlési (RBAC) szerepkörök hozzáadása a társított tárfiókhoz

1. Nyissa meg a társított tárfiókot az Azure Portalon.

2. Lépjen a Hozzáférés-vezérlés (IAM) lapra.

   

3. Válassza a Szerepkör-hozzárendelés hozzáadása lehetőséget.

   

4. A Feladatfüggvény-szerepkörök csoportban keresse meg és válassza a Storage Blob Data Közreműködő szerepkört, és kattintson a Tovább gombra.

   

5. Jelölje ki és vegye fel a teszteket futtató összes tagot.

   

6. Kattintson a Véleményezés + hozzárendelés gombra.

Playwright-munkaterületek csomag telepítése

A Playwright-munkaterületek használatához telepítse a Playwright Workspaces csomagot.

npm init @azure/playwright@latest

Ez a parancs létrehoz egy playwright.service.config.ts fájlt, amely a Playwrightot irányítja és hitelesíti a Playwright munkaterületekhez.

Ha már rendelkezik ezzel a fájllal, a csomag megkéri, hogy írja felül.

A HTML és Playwright munkaterületek riportereinek engedélyezése

A Playwright Workspaces jelentéskészítési funkciójának használatához engedélyezze a html és a Playwright Workspaces riportert a következő beállítás hozzáadásával a playwright.service.config.ts fájlban –

reporter: [
    ["html", { open: "never" }], // HTML reporter must come first
    ["@azure/playwright/reporter"], // Azure reporter uploads HTML report
]

Összetevők engedélyezése a Playwright-beállításban

A projekt playwright.config.ts fájljában győződjön meg arról, hogy az összes szükséges összetevőt összegyűjti.

use: 
{
    trace: 'on-first-retry',
    video:'retain-on-failure',
    screenshot:'on'
}

A böngészővégpont konfigurálása

A beállítás során meg kell adnia a régióspecifikus böngészővégpontot. A végpont a munkaterület létrehozásakor kiválasztott Azure-régiótól függ.

A böngészővégpont URL-címének lekéréséhez hajtsa végre a következő lépéseket:

1. Jelentkezzen be az Azure Portalra az Azure-fiókjával, és lépjen a munkaterületre.

2. Válassza az Első lépések lapot.

   

3. A böngészővégpont hozzáadása a beállításhoz másolja a végpont URL-címét.

   Győződjön meg arról, hogy ez az URL-cím elérhető a PLAYWRIGHT_SERVICE_URL környezeti változóban.

   

Saját környezet beállítása

A környezet beállításához konfigurálnia kell a PLAYWRIGHT_SERVICE_URL környezeti változót az előző lépésekben kapott értékkel.

A dotenv modult használva kezelheti a környezetet. dotenvA használatával meghatározhatja a környezeti változókat a .env fájlban.

1. Adja hozzá a modult dotenv a projekthez:

   npm i --save-dev dotenv
   

2. Adja hozzá a következő kódrészletet a következőbe playwright.service.config.ts:

   require('dotenv').config();
   

3. Hozzon létre egy .env fájlt a playwright.config.ts fájl mellett a Playwright-projektben:

   PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}
   

   Ügyeljen arra, hogy a {MY-REGION-ENDPOINT} szöveghelyőrzőt cserélje le a korábban másolt értékre.

Hitelesítés beállítása

Ha a Playwright-teszteket a Playwright-munkaterületen szeretné futtatni, hitelesítenie kell a Playwright-ügyfelet, ahol a teszteket a szolgáltatással futtatja. Hitelesítés a helyi fejlesztői gépről vagy a CI-gépről.

Megjegyzés:

A Playwright Workspaces riportere csak a Microsoft Entra ID-alapú hitelesítést támogatja. Ha hozzáférési jogkivonatokat használ a hitelesítéshez, nem használhat jelentéskészítést.

Hitelesítés beállítása a Microsoft Entra-azonosítóval

A Playwright Workspace jelentéskészítési funkciójának használatához a Microsoft Entra ID az egyetlen támogatott hitelesítés. A helyi fejlesztői gépről az Azure CLI használatával jelentkezhet be

az login

Megjegyzés:

Ha több Microsoft Entra-bérlő tagja, mindenképpen jelentkezzen be arra a bérlőre, amelyhez a munkaterület tartozik. A bérlőazonosítót az Azure Portalról szerezheti be. Lásd: A Microsoft Entra-bérlő megkeresése. Miután megkapta az azonosítót, jelentkezzen be a paranccsal az login --tenant <TenantID>

Tesztek futtatása Playwright-munkaterületekkel

Elvégezte a Playwright-tesztek felhőben való futtatásának konfigurációját a Playwright-munkaterületekkel. A playwright parancssori felülettel futtathatja a teszteket, vagy használhatja a Playwright Test Visual Studio Code bővítményt.

Drámaíró parancssori felülete

1. Nyisson meg egy terminálablakot.

2. Írja be a következő parancsot a Playwright tesztcsomag távoli böngészőkben való futtatásához a munkaterületen:

   npx playwright test --config=playwright.service.config.ts --workers=20
   

   A tesztcsomag méretétől függően ez a parancs legfeljebb 20 párhuzamos feldolgozón futtatja a teszteket.

Visual Studio Code

A Playwright tesztcsomag futtatása a Visual Studio Code-ban Playwright-munkaterületekkel:

1. Nyissa meg a Test Explorer nézetet a tevékenységsávon.

2. A Teszt futtatása gombra kattintva az összes teszt lefuttatható a Playwright-munkaterületekkel.

   Az összes teszt futtatásakor a rendszer az alapértelmezett profilt használja. Az előző lépésben úgy konfigurálta az alapértelmezett profilt, hogy a szolgáltatáskonfigurációból származó projekteket használjon.

   

   Jótanács

   A tesztkód hibakereséséhez használja a Hibakeresési tesztek gombot, amikor távoli böngészőkben futtatja a teszteket.

3. Másik lehetőségként kiválaszthat egy adott szolgáltatáskonfigurációt a listából, hogy csak egy adott böngészőkonfiguráció tesztjeit futtassa.

   

4. Az összes teszteredmény megtekintése a Teszteredmények lapon.

Hibakeresési tesztfuttatások és eredmények az Azure Portalon

Szerepköralapú hozzáférés-vezérlési (RBAC) szerepkörök hozzáadása a társított tárfiókhoz

1. Nyissa meg a társított tárfiókot az Azure Portalon.

2. Lépjen a Hozzáférés-vezérlés (IAM) lapra.

   

3. Válassza a Szerepkör-hozzárendelés hozzáadása lehetőséget.

   

4. A Kiemelt rendszergazdai szerepkörök csoportban keresse meg és válassza ki a Közreműködő* szerepkört, majd kattintson a Tovább gombra.

   

5. Jelölje ki és vegye fel az összes olyan tagot, aki megtekintheti a tesztjelentéseket.

   

6. Kattintson a Véleményezés + hozzárendelés gombra.

(Csak akkor, ha a nyomkövetés engedélyezve van) Nyilvános nyomkövetési megjelenítő engedélyezése a csatolt tárfiókban

1. Nyissa meg a társított tárfiókot az Azure Portalon.

2. Válassza a Beállítások –> Erőforrás-megosztás (CORS) lehetőséget.

   

3. A Blob szolgáltatásban adjon hozzá egy új rekordot:

   • Engedélyezett források: https://trace.playwright.dev
   • Engedélyezett metódusok: GET, OPTIONS
   • Maximális életkor: Adjon meg 0 és 2147483647 közötti értéket.

   

4. Válassza az Mentésgombot.

Mentett tesztjelentések megtekintése az Azure Portalon

Mostantól az Azure Portalon is elháríthatja a sikertelen tesztelési eseteket.

1. A tesztfuttatás befejezése után a riporter létrehoz egy hivatkozást az Azure PortalTesztfuttatások lapjára. Nyissa meg ezt a hivatkozást a részletes teszteredmények és a kapcsolódó összetevők megtekintéséhez.

   

2. A Tesztfuttatások lap a hibaelhárításhoz szükséges összes információt tartalmazza. Ön megteheti:

   • Részletes hibanaplók, tesztelési lépések és csatolt összetevők, például képernyőképek vagy videók megtekintése.
   • A mélyebb elemzéshez lépjen közvetlenül a Nyomkövetési megjelenítőbe .

   

3. A Trace Viewer lehetővé teszi, hogy vizuálisan lépésről lépésre végigmenjen a teszt végrehajtásán. Ön megteheti:

   • Az ütemterv használatával rámutathat az egyes lépésekre, és minden művelet előtt és után felfedheti a lap állapotát.
   • Ellenőrizze az egyes lépések részletes naplóit, DOM-pillanatképeit, hálózati tevékenységét, hibáit és konzolkimenetét .

   

Jótanács

A jobb felhasználói élmény érdekében nyissa meg a nyomkövetési megjelenítőt egy új böngészőlapon a Ctrl gomb lenyomásával és a Nyomkövetés megtekintése lehetőség kiválasztásával.