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
-1 = Non eseguito
-2 = Fallito
-3 = Terminato ma non avviato
-4 = Nome timer vuoto
-5 = Errore Selenium

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
-1 = Errore generale
-10 = Esecuzione non riuscita
-11 = Parametro mancante
-12 = File robot non trovato
-13 = Errore Selenium

Error code

Codice di errore generico del job (vedere la sezione Codici di errore dei job)