אוטומציית בדיקות - כיצד לקשר עקבות והקלטות וידאו של Playwright לדוח Allure באמצעות GitHub Actions

הקדמה

בעת הרצת בדיקות אוטומציה לדפדפן עם כלים כמו Playwright, קבלת תובנות מפורטות על ביצוע הבדיקות יכולה להיות בעלת ערך רב לצורך פתרון בעיות וניתוח. Playwright מציע יכולות מעקב (tracing) והקלטת וידאו חזקות הלוכדות מידע מקיף על כל הרצת בדיקה. עם זאת, שילוב של ארטיפקטים אלה עם כלי דיווח פופולריים כמו Allure יכול לשפר את חווית הבדיקה הכוללת ולספק מיקום מרכזי לניתוח בדיקות.

במאמר זה, נחקור כיצד למנף את GitHub Actions כדי לקשר עקבות והקלטות וידאו של Playwright לדוחות Allure, ובכך לספק זרימת עבודה חלקה להדמיה וחקר של תוצאות הבדיקה.

הפתרון המוצג במאמר זה מודגם בפרויקט הדוגמה שלי Playwright Python example project, שפותח בשיתוף עם אליאס שורוש.

יישום הפתרון

ניתן למצוא את קוד הפתרון כאן.

היישום כולל שני שלבים עיקריים בזרימת עבודה של GitHub Actions:

1. אחסון עקבות והקלטות וידאו של Playwright מבדיקות שנכשלו

- name: Store Playwright Traces and Videos From Failed Tests
  if: failure()
  uses: actions/upload-artifact@v4.3.1
  id: artifact-upload-step
  with:
    name: test-results
    path: test-results/
    retention-days: 7

שלב זה משתמש בפעולת actions/upload-artifact כדי להעלות את העקבות והקלטות הווידאו של Playwright מבדיקות שנכשלו לארטיפקט של GitHub Actions. התנאי if: failure() מבטיח ששלב זה ירוץ רק אם לפחות בדיקה אחת נכשלת, מה שמפחית העלאות ארטיפקטים מיותרות. הפרמטר path מציין את ספריית העקבות והקלטות הווידאו ו-retention-days קובע את מספר הימים לשמירת הארטיפקט.

2. קישור עקבות והקלטות וידאו של Playwright לדוח Allure

- name: Link Playwright Traces And Videos To Allure Report
  working-directory: allure-results
  if: failure()
  run: echo ARTIFACT_URL=${{ steps.artifact-upload-step.outputs.artifact-url }} >> environment.properties

שלב זה יוצר קובץ environment.properties בתוך ספריית allure-results, שהיא המיקום שבו נוצרים נתוני דוח Allure. פקודת run כותבת את כתובת ה-URL של הארטיפקט שהועלה למשתנה הסביבה ARTIFACT_URL בקובץ environment.properties. כתובת ה-URL משמשת את Allure כדי לקשר את העקבות והקלטות הווידאו של Playwright לתוצאות הבדיקה המתאימות בדוח. שימו לב שהתנאי if: failure() מבטיח ששלב זה ירוץ רק אם לפחות בדיקה אחת נכשלת, ובכך נמנעת כתיבת קובץ מיותרת כאשר כל הבדיקות עוברות.

צפייה בתוצאות הבדיקה

כאשר העקבות והקלטות הווידאו של Playwright מקושרים לדוח Allure, ניתן כעת לצפות ולנתח את תוצאות הבדיקה בפירוט רב יותר. בעת פתיחת דוח Allure, תמצאו קישורים לארטיפקטים המתאימים של Playwright עבור בדיקות שנכשלו.

לחיצה על קישורים אלה תאפשר לכם להוריד ולבדוק את העקבות והקלטות הווידאו, ובכך לספק תובנות יקרות ערך על ביצוע הבדיקה ועל בעיות פוטנציאליות.

לסיכום

שילוב עקבות והקלטות וידאו של Playwright עם דוחות Allure באמצעות GitHub Actions משפר את זרימת העבודה של הבדיקות על ידי מתן מיקום מרכזי לניתוח בדיקות מקיף. על ידי מינוף העוצמה של יכולות המעקב והקלטת הווידאו של Playwright, ושילובן עם תכונות הדיווח העשירות של Allure, ניתן להשיג תובנות עמוקות יותר על ביצוע הבדיקות, לייעל תהליכי ניפוי באגים, ובסופו של דבר לשפר את האיכות הכוללת של התוכנה.