Job Selenium con timer
Funzione | Questo plugin serve per eseguire test web utilizzando il framework Selenium. Esegue test basati su RobotFramework o Python su un browser Chrome headless installato su un collector, attende il termine dell'esecuzione, quindi recupera i file di log generati e li visualizza in una pagina riepilogativa. |
|---|---|
Allarmi | Run time, Response code, Result code |
Informazioni generali sul job Selenium
I progetti Selenium possono essere creati utilizzando il linguaggio RobotFramework oppure Python.
Per rendere disponibili i file di progetto Selenium sui collector esterni, i servizi SKOOR syncfs devono essere configurati e in esecuzione. L'utente reranger deve essere configurato per accedere senza password, come descritto nella guida alla replica
RobotFramework
Un file robot viene generato utilizzando l'intestazione da /opt/eranger/collector/robot.robot e accodando il file fornito nell'Engine. Solo in casi particolari l'utente potrebbe voler fornire un file robot completo. Una buona fonte di informazioni sulle funzionalità disponibili è la RobotFramework User Guide. I file robot vengono salvati in /opt/eranger/collector/upload/
Sezione delle informazioni nella configurazione del job:
L'estensione per Chrome o Firefox Katalon Recorder può essere utilizzata per registrare una procedura di test ed esportare la parte del test case (formato: robot framework).
Script di esempio:
Un semplice file robot potrebbe quindi avere il seguente aspetto:
[Teardown] Run Keyword If Test Failed Capture Page Screenshot
Set Window Size ${1920} ${1200}
Start Timer totalTime
Start Timer Open
Goto https://my.great.business.com/
Stop Timer Open
click link=Business
sleep 3s
Stop Timer totalTime
Uno script più avanzato con più timer e blocchi TRY/EXCEPT:
Start Timer TotalTime
Start Timer Open
TRY
Goto https://my.great.business.com/
Stop Timer Open
EXCEPT
Capture Page Screenshot
Error Timer Website unavailable
ErrorCode Timer 11
Stop Timer Open
END
Start Timer Contact
TRY
click link=Contact
Stop Timer Contact
EXCEPT
Capture Page Screenshot
Error Timer Contact link failed
ErrorCode Timer 22
Stop Timer Contact
END
sleep 2s
Start Timer Home
TRY
click link=Home
Stop Timer Home
EXCEPT
Capture Page Screenshot
Error Timer Home link failed
ErrorCode Timer 33
Stop Timer Home
END
sleep 2s
Stop Timer TotalTime
Python
I moduli Python di Selenium e SKOOR per il web testing con Selenium sono preinstallati nei SKOOR Collector. Gli script Python possono essere sviluppati e utilizzati direttamente con il plugin. Inoltre, è possibile utilizzare Selenium IDE per registrare i casi d'uso.
Sezione delle informazioni nella configurazione del job:
Script di esempio: per prima cosa vengono importati i moduli richiesti e impostati i parametri del browser. Successivamente viene avviato il timer SKOOR totalTime e viene eseguito un passaggio di test in un blocco try/except con un secondo timer, step1. In questo modo i timer possono essere configurati e utilizzati in seguito nella SKOOR Engine.
#!/usr/bin/python3
import sys, time, skoor, traceback
from skoor import SkoorTimer, Variables, SkoorScreenshot
from selenium import webdriver
from selenium.webdriver import Chrome
from selenium.webdriver import ChromeOptions
from selenium.webdriver.common.desired_capabilities import DesiredCapabilities
opts = ChromeOptions()
opts.add_argument("--headless=new")
opts.add_argument("--no-sandbox")
opts.add_argument("--disable-setuid-sandbox")
opts.add_argument("--disable-gpu")
opts.add_argument("--allow-running-insecure-content")
opts.add_argument("--disable-extensions")
opts.add_argument("--ignore-certificate-errors")
opts.binary_location = os.getenv("SKOOR_PUPPETEER_CHROME_EXECUTABLE")
cap = DesiredCapabilities().CHROME
cap["marionette"] = True
driver = webdriver.Chrome(chrome_options=opts)
skoor.setLogLevel(skoor.INFO)
driver.set_window_size(1920,1200)
totalTime = SkoorTimer("TotalTime")
step1 = SkoorTimer("Step 1")
totalTime.start()
try:
step1.start()
skoor.log(skoor.INFO, "Search started")
driver.get("https://xyz.com")
driver.find_element_by_id("html-element1")
skoor.log(skoor.INFO, "Step 1 done")
step1.stop()
except:
skoor.log(skoor.ERROR, traceback.format_exc())
SkoorScreenshot().capture(driver)
step1.error(-2, "Step 1 failed")
totalTime.stop()
driver.quit()
skoor.log(skoor.INFO, "Script done")
Se è stato utilizzato Selenium IDE per registrare un test case, il contenuto della funzione test_<name> può essere copiato in un blocco try dello script Python 3:
def test_dict(self):
self.driver.get("https://dict.leo.org/englisch-deutsch/")
self.driver.set_window_size(1515, 948)
self.driver.find_element(By.LINK_TEXT, "Forum").click()
Se Selenium IDE ha utilizzato moduli Python aggiuntivi come by o key, tali moduli devono essere aggiunti anche alla sezione di importazione dello script finale:
#!/usr/bin/python3 import sys, time, skoor, traceback from skoor import SkoorTimer, Variables, SkoorScreenshot from selenium import webdriver from selenium.webdriver import Chrome from selenium.webdriver import ChromeOptions from selenium.webdriver.common.desired_capabilities import DesiredCapabilities from selenium.webdriver.common.by import By from selenium.webdriver.common.keys import Keys ...
È importante che l'operazione driver.quit() venga eseguita in ogni caso. In caso contrario si verificherà una perdita di risorse!
Dispositivo Selenium
Quando si crea un dispositivo Selenium viene visualizzata la seguente schermata delle opzioni di configurazione:
Il plugin Selenium verrà eseguito in un browser headless direttamente sul collector selezionato.
Parametri del job Selenium
Parametro | Descrizione |
|---|---|
Run time limit | Specifica il tempo massimo consentito per l'esecuzione del progetto. Questo dipende dalle operazioni eseguite dal progetto. Questo parametro è facoltativo; un valore pari a 0 o lasciato vuoto indica che non verrà impostato alcun timeout. |
Suite name | Se viene fornito un file robot completo con 'Settings' ecc., viene eseguito senza modifiche. Solitamente è richiesta solo la parte 'Test Case'. In tal caso l'intestazione viene presa da /opt/eranger/collector/robot.robot. |
Proprietà Selenium
Parametro | Descrizione |
|---|---|
Selenium Option | Tramite questa proprietà è possibile impostare sequenze di escape e altre opzioni. |
Selenium Variable | In questa proprietà è possibile definire variabili per il file robot, ad esempio INFO:info o TIMEOUT:0 |
Dettagli dei timer Selenium
Allo stesso modo in cui i job timer vengono aggiunti ai job di progetto EEM, è possibile aggiungere job timer sotto un job Selenium. L'unico parametro è il nome del timer.
I timer che contengono una voce di avvio e una di arresto (generate da “Stop Timer” o “Pause Timer”) sono considerati riusciti.
Per utilizzare i timer nel file robot sono disponibili le seguenti parole chiave
Start Timer $name
Pause Timer $name
Resume Timer $name
Stop Timer $name
Parametri dei timer Selenium
Parametro | Descrizione |
|---|---|
Timer name | In un job Selenium Timer è possibile configurare solo il nome del job e il nome del timer. Il campo Name del job può essere diverso da Timer name, ma Timer name deve corrispondere al nome del timer scritto nel file robot. |
Valori e limiti di allarme dei timer Selenium
Valore / Limite di allarme | Descrizione |
|---|---|
Run time | Il tempo di esecuzione di questo specifico timer |
Result code | 0 = OK |
Error code | Codice di errore generico del job (vedere la sezione Codici di errore dei job) |
Risultati Selenium
Dopo un'esecuzione del plugin, la sezione dei valori del job Selenium appare così:
oppure in caso di errore durante l'esecuzione:
Facendo clic sul collegamento Result files nella sezione Values si aprirà la seguente nuova scheda del browser:
Questa pagina fornisce una panoramica dei test eseguiti e dei relativi risultati. Per ogni esecuzione in cui i log sono stati raccolti da SKOOR Engine è presente una riga con un timestamp e un collegamento al file dei risultati corrispondente. Se si sono verificati errori durante un'esecuzione, il collegamento viene inserito nella colonna Failed tests, insieme a uno screenshot (se acquisito dallo script) e ai timer non riusciti. Ciò fornisce generalmente un'indicazione chiara sul motivo del fallimento di un'esecuzione di test.
Facendo clic su Report file nella sezione Values si aprirà una pagina HTML che include una panoramica dell'output di esecuzione e un collegamento a un file di report HTML più dettagliato (lo stesso file a cui è possibile accedere anche direttamente nella sezione dei valori).
Valori e limiti di allarme Selenium
Valore / Limite di allarme | Descrizione |
|---|---|
Run time | Il tempo di esecuzione del plugin |
Result code | 0 = OK |
Error code | Codice di errore generico del job (vedere la sezione Codici di errore dei job) |






