Architecture Decision Record
← Ensamplow kovskrif dyberth

Kovskrif dyberth arkitektoryeth: framweyth awtomatiansa peurell rag previansow E2E (Playwright erbynn Selenium)

1. Kettesten

Ni yw ow tewis framweyth awtomatiansa peurell rag agan pibell previansow penn-dhe-benn (E2E). An framweyth ma a vydh poesek dhe'gan argerdhow CI/CD, ow kweythi previansow a hevelepa ynterweythyansow usyer wir war agan blatform. Arbennik, an previansow a dhalghen senaryos avel omskrifa/omlogya usyer, ughelhe fayls, ynterweythyansow dashboard, ha ughwarthva derivasow.

Avel dallethyans, agan fok yw war displegyans skav, gans othom a ailtrei skon ha displegya. Agan tim a oberi dhe-gresek gans TypeScript ha Python, ha'n gallos dhe skrifa previansow y'n yethow ma yw poesek. Ouryen, an blatform a'n jeves chartys ynterweythek ha dashboards, a wra kritek may skoodhho an toul awtomatiansa UIyow rych, dynamek yn da.

An dhew ymgeslywyor rag an tasken ma yw Playwright ha Selenium, pub unn gans y nerthow ha'y stokyow-trelyes. Res yw dhyn jydja an framweythow ma herwydh an nodhow ha'n othommow displegys a-woles.

2. Dewisyow kemerys yn kyfrif

  • Playwright (gans Microsoft)
  • Selenium (gans Towl Selenium)

3. Gyrryoryon dyberth

An fylmys a drehedh agan dyberth yw an re a sew:

  1. Displegyans skav: Res yw dhe'n toul dewisys konsentya bywnansow displegyans skon ha fexibl.
  2. Skoodh yethow: Agan tim a'n jeves othom a skoodh rag TypeScript ha Python ynwedh.
  3. Previans UI ynterweythek: An gallos dhe previ chartys ynterweythek, dashboards, hag elvennow dynamek yn fydhek yw poesek.
  4. Skavder gweythrys: Kyn na vo penn-bris, gwrians yn pibellow CI/CD yw konsiderasyon.
  5. Skalyadewder: Ny dowlenn ni rag skalyi bras y'n termyn nes, mes ni a vynn surhe may hyllo an solusyon rewlya tevyans a-dheu.
  6. Kesstowans a-dhelergh: Systemow hen ha kesstowans gans peurellow koth nyns yns kritek rag agan towl lemmyn.
  7. Previans symudek: Kyn na vo fok dhe-nes, an framweyth a dal bos abyl dhe brevi nodhow symudek-gorthyp po bos ystynnadow rag kasow usadow a'n par ma.
  8. Previans multi-monitor: Skoodh rag kefrysyansow multi-monitor yw othom nessa, arbennik mar skalyi vyth dhe brevi fluvyow-ober usyer moy kompleks.
  9. Previans ughelhe fayl: An framweyth a dal rewlya ughelhe fayls yn effeythus, othom kresek a'gan previansow.

4. Kriteryow jydjyans

  • Es dhe usya: Pygemmys yw es skrifa ha gwitha previansow?
  • Skoodh yethow: A skoodh an framweyth TypeScript ha Python, an dhew yeth a usya agan tim an moyha fenowgh?
  • Previans UI ynterweythek: Fatel dha y rewl an framweyth ynterfasow usyer kompleks, ynterweythek avel chartys, ughelhe fayls, ha data dynamek?
  • Junyans CI/CD: Fatel dha y junn an framweyth gans toulys ha gwassanethow CI/CD ollgemmyn?
  • Skoodh peurellow: Pyth peurellow yw skoodhys ha fatel dha y fons i?
  • Gwrians ha skavder: Pygemmys skon y hwra previansow oberi, arbennik yn pibell CI/CD?
  • Skalyadewder: Fatel dha y hyll an framweyth skalyi mar pe previansow moy po senaryos moy kompleks ystynnys?
  • Kemenethow ha ekosystem: Pygemmys bewek yw kemeneth an framweyth? A eus lies junyans hag ystynnans a-dhisplegyans?

5. Konsiderasyons

5.1 Playwright

A-dhesk:
  1. API gwell rag ughelhe fayls leel: API Playwright rag ynterweythya gans fayls leel ha gul ughelhe fayls yw moy sempel ha moy ynnynnek. Hemma a wra previans ughelhe fayl es dhe weythi ha gwitha.
  2. Syntaks ha jeneredh kod: Syntaks Playwright yw moy kyns ha moy berr. Hemma a dhre nebes kod boilerplate, a wellha gwithadewder ha effeythyonsi displegyor. Ouryen, an syntaks verr ma a wellha ansawdh jeneredh kod OpenAI, ow konsentya jeneredh awtomatek a skriptys previans es.
  3. Previans UI ynterweythek: Playwright a ra yn ragorek orth previ aplikasyons gwew dynamek, ynterweythek, avel an re gans chartys rych, ynterweythyansow usyer kompleks, ha nowydhyansow real-termyn. Ev a rewl WebSockets, WebRTC, shadow DOMs, ha teknologiow gwew nowydhek erell pur effeythus.
  4. Skoodh peurellow: Playwright a skoodh Chromium, WebKit, ha Firefox. Ev a'n jeves gwrians kesson a-dreus an peurellow ma, a dhelirh an moyha a'gan othommow previans.
  5. Junyans CI/CD: Playwright a junn heb ankombrans gans platformow CI/CD nowydhek (GitHub Actions, Jenkins, hag yn.). Ev a hyll gweythi previansow yn kesstrif a-dreus peurellow dyffrans, ow gwellhe termynyow gweythrys previansow ha dh'y wul gwiw rag displegyans skav.
  6. Skav ha fydhek: Playwright yw moy skav es Selenium yn ollgemmyn, arbennik yn modh headless, ha moy krev orth elvennow gwew asynchronek.
Drog:
  1. Previans symudek kyfyngys: Kyn skoodhi Playwright hevelepyans symudek rag peurellow, ev a'n jeves ol rag nodhow previans symudek genesek avel junyans Selenium gans Appium rag gwir brevi symudek.
  2. Ekosystem byghan: Playwright yw hwath nowydh ha le selys es Selenium. Kyn fo y gemeneth ow tevi skon ha dogvennans da, martesen nyns eus dhodho hwath an ekosystem ledan a bluginys ha junyansow a brof Selenium.
  3. Skoodh peurellow kyfyngys: Kyn fo Playwright ow kudha an peurellow nowydhek poesek (Chrome, Safari, Firefox), y skoodh rag peurellow koth (rag ensampel, Internet Explorer) nyns yw mar grev avel an re Selenium.

5.2 Selenium

A-dhesk:
  1. Istori hirra ha prederyans: Selenium re beu a-dro termyn hir ha'n jeves rekord previys. Ev yw usys yn ledan a-dreus lies tim ha diwysyans, a dhrehedhas ekosystem ledan a bluginys, junyansow, ha fentenow.
  2. Skoodh peurellow ha platformow: Selenium a skoodh lies sort a beurellow ha gwersyons, ow keworra Internet Explorer, ha hyll bos junys ynwedh gans lies toul avel Docker, Selenium Grid, ha gwassanethow kommol rag previansow skoranys.
  3. Previans symudek: Selenium, dre y junyans gans Appium, yw meur moy krev rag previansow symudek, ow keworra aplikasyons Android ha iOS. Hemma a wra ev an dewis gwell rag towlow a'n jeves fok symudek-kynsa po symudek-pur.
  4. Previans multi-monitor: Selenium a re gwell skoodh rag senaryos ow keworra lies monitor po ynterweythyansow kompleks multi-fenester.
Drog:
  1. Kompleksyta: API Selenium yw moy hirgows ha splann. Kyn hyll hemma bos a-dhesk yn nebes kasow, ev a styr moy kod dhe skrifa ha gwitha, a hyll lehe fexibilita displegyor—arbennik poesek yn kerghynnedh dallethyans.
  2. Gwrians: Selenium a wra yn ollgemmyn oberi moy hweg es Playwright, arbennik yn modh headless. Hemma a hyll drehedha pibellow CI/CD, arbennik pan dhe niver a brevyansow.
  3. Previans UI ynterweythek: Selenium nyns yw mar vyl avel Playwright pan dhe dhe brevi UIyow gwew ynterweythek nowydhek, arbennik gans chartys ha nowydhyansow data real-termyn. Ev a res moy selyans ha gweithrys rag ynterweythya yn fydhek gans kenwyns dynamek.

6. Berrskrif keheveli

Nodh Playwright Selenium
Es dhe usya Syntaks berrha, moy ynnynnek rag UIyow nowydhek Moy splann, a res moy boilerplate
Skoodh yethow TypeScript, Python, JavaScript TypeScript, Python, Java, Ruby, C#
Previans UI ynterweythek Ragorek rag UIyow dynamek, real-termyn A rewl UIyow sempel, mes moy hirgows ha kompleks rag ynterweythyansow rych
Previans ughelhe fayl API gwell rag ughelhe fayls Moy hirgows, API le ynnynnek
Junyans CI/CD Junyans es gans GitHub Actions, Jenkins Junyans krev gans lies toul CI
Previans symudek Kyfyngys, hevelepyans hepken Skoodh leun dre Appium
Skoodh peurellow Chromium, WebKit, Firefox Skoodh leun a-dreus peurellow pennys ha koth
Gwrians Skav, gwellhes rag previans headless Moy hweg, arbennik yn modh headless
Previans multi-monitor Kyfyngys Skoodh da rag kefrysyansow multi-monitor
Kemeneth ha ekosystem Ow tevi, dogvennans da Bras, prederys, ekosystem ledan

7. Dyberth

Wosa kemeres yn kyfrif an othommow ha'n stokyow-trelyes, Playwright yw an dewis gwell rag agan othommow lemmyn. Y API gwell rag previans ughelhe fayls leel, syntaks berr, ha skoodh krev rag previans UI ynterweythek a wra ev gwiw ideal rag agan bywnans displegyans skav. An fakt may skoodh ev TypeScript ha Python ynwedh yw kritek rag agan tim, ha fordh nowydhek an framweyth dhe brevi a gonsent dhyn skrifa kod glan, gwithadow.

Kyn fo Selenium hwath toul meurdhy, arbennik rag previans symudek, skoodh peurellow koth, ha selyansow multi-monitor, ev yw le gwiw dhe'gan othommow lemmyn. Y hirgowsder, gwrians moy hweg, ha rewlyans moy kompleks a UIyow dynamek avel chartys a wra ev le gwell rag agan kas usadow.

8. Sewyansow

  • Ober skon: Ni a dhegemmer Playwright rag agan previansow E2E, ow fokusya war previ fluvyow usyer ow keworra omskrifa, omlogya, ughelhe fayls, dashboards, ha ughwarthva derivasow.
  • Konsiderasyons hirdermyn: Ni a with lagas war ekosystem Playwright ow tevi. Mar chanj agan othommow, arbennik a-dro dhe brevi symudek po skoodh peurellow koth, martesen y hwrewn dasvewa Selenium.
  • Dyskans ha dogvennans: Timyow displegyans a res dhedha dos aswonnys gans API Playwright, arbennik rag rewlya UIyow dynamek ha ughelhe fayls.
  • Treylyans: Previansow Selenium a vo (mar pe) a vydh treylys yn tomm dhe Playwright.

9. Konsiderasyons a-dheu