Tutorial Sikuli per Selenium Automazione

In cosa consiste Sikuli Selenium?

Siculi è uno strumento di automazione dei test basato su GUI open source. È utilizzato principalmente per interagire con elementi di pagine web e gestire popup basati su finestre. Sikuli utilizza la tecnica di "Image Recognition" e "Control GUI" per interagire con elementi di pagine web e popup di finestre. In Sikuli, tutti gli elementi web sono presi come immagini e archiviati all'interno del progetto.

⚠️ Nota sulla denominazione: Il progetto è mantenuto oggi come SikuliX, pubblicato su Maven Central come com.sikulix:sikulixapiI nomi delle classi riportati di seguito rimangono invariati.

Come usare Sikuli con Selenium Webdriver

Sikuli può essere integrato con Selenium WebDriver utilizza il file JAR di Sikuli, seguendo i due passaggi descritti di seguito.

Passaggio 1) Scarica il file JAR di Sikuli dal punto seguente URL, ed extracspostare il contenuto del file ZIP in una cartella.

https://mvnrepository.com/artifact/com.sikulix/sikulixapi/2.0.5

Passo 2) Crea un nuovo progetto Java in Eclipse e aggiungi il file JAR al percorso di compilazione, insieme ai file JAR di Selenium, facendo clic con il pulsante destro del mouse sul progetto -> Percorso di compilazione -> Configura percorso di compilazione, come mostrato di seguito.

Una volta aggiunto il file JAR al percorso di compilazione del progetto, è possibile utilizzare le classi fornite da Sikuli. In alternativa, un progetto Maven può dichiarare lo stesso artefatto come dipendenza.

Lezione di schermo a Sikuli

La classe Screen è la classe base per tutti i metodi forniti da Sikuli. La classe Screen contiene metodi predefiniti per tutte le operazioni comunemente eseguite sugli elementi dello schermo, come clic, doppio clic, inserimento di input in una casella di testo, passaggio del mouse, ecc. Di seguito è riportato l'elenco dei metodi più comunemente utilizzati forniti dalla classe Screen.

Lezione di modelli a Sikuli

Mentre Screen agisce su un semplice nome di immagine, la classe Pattern viene utilizzata per associare al file immagine attributi aggiuntivi che identificano in modo univoco l'elemento. Accetta come parametro il percorso dell'immagine.

Pattern p = new Pattern(“Path of image”);

Di seguito sono riportati i metodi più comunemente utilizzati della classe Pattern.

Code Esempio di caricamento di file tramite Sikuli

Il codice seguente illustra l'utilizzo di Sikuli per il caricamento di file in Chrome.

package com.sikuli.demo;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.sikuli.script.FindFailed;
import org.sikuli.script.Pattern;
import org.sikuli.script.Screen;
import org.openqa.selenium.chrome.ChromeDriver;

public class SikuliDemo {

    public static void main(String[] args) throws FindFailed {

        System.setProperty("webdriver.chrome.driver", "D:\\chromedriver.exe");
        String filepath = "D:\\Guru99Demo\\Files\\";
        String inputFilePath = "D:\\Guru99Demo\\Files\\";
        Screen s = new Screen();
        Pattern fileInputTextBox = new Pattern(filepath + "FileTextBox.PNG");
        Pattern openButton = new Pattern(filepath + "OpenButton.PNG");
        WebDriver driver;

        // Open Chrome browser    
        driver = new ChromeDriver();
        driver.get("https://demo.guru99.com/test/image_upload/index.php");

        // Click on Browse button and handle windows pop up using Sikuli
        driver.findElement(By.xpath(".//*[@id='photoimg']")).click();
        s.wait(fileInputTextBox, 20);
        s.type(fileInputTextBox, inputFilePath + "Test.docx");
        s.click(openButton);

        // Close the browser
        driver.close();
    }
}

Code Spiegazione

Passo 1) La prima istruzione prevede l'impostazione del percorso eseguibile del driver per Chrome.

System.setProperty("webdriver.chrome.driver", "D:\\ chromedriver.exe");

⚠️ Nota sulla versione: Selenium 4 risolve il binario del driver tramite Selenium Responsabile, quindi questa riga ora è facoltativa. Viene mantenuta così come è stata scritta dalla fonte.

Passo 2) Utilizza uno strumento di cattura dello schermo come Snipping Tool per fare screenshot del popup di Windows 'FileTextBox' e il pulsante 'Apri', come mostrato di seguito.

Ecco come dovrebbe apparire la tua schermata:

Le immagini per la casella di testo di input del file di Windows e il pulsante Apri vengono memorizzate su 'FileTextBox.PNG' e 'OpenButton.PNG'.

Esempio: se desideri automatizzare l'operazione di apertura del Blocco note, devi memorizzare l'immagine di un'icona sul desktop per il Blocco note in un file PNG ed eseguire l'operazione di clic su di esso.

Nel nostro caso, riconosce la casella di testo di input del file e il pulsante Apri su Windows popup utilizzando le immagini memorizzate. Se la risoluzione dello schermo cambia dall'acquisizione dell'immagine all'esecuzione dello script di test, il comportamento di Sikuli sarebbe incoerente. Quindi è sempre consigliabile eseguire lo script di test alla stessa risoluzione con cui vengono acquisite le immagini. La modifica delle dimensioni in pixel delle immagini comporterà il lancio di un'eccezione FindFailed da parte di Sikuli.

Passo 3) Le istruzioni successive includono la creazione di oggetti per le classi Screen e Pattern. Crea un nuovo oggetto sullo schermo. Imposta il percorso del file che desideri caricare come parametro nell'oggetto Pattern.

Screen s = new Screen();
Pattern fileInputTextBox = new Pattern(filepath + "FileTextBox.PNG");
Pattern openButton = new Pattern(filepath + "OpenButton.PNG");

Passo 4) Le seguenti affermazioni riguardano l'apertura del browser Chrome con URL di un'applicazione dimostrativa per il caricamento di file: https://demo.guru99.com/test/image_upload/index.php

driver = new ChromeDriver();
driver.get("https://demo.guru99.com/test/image_upload/index.php");

Passo 5) Fare clic sul pulsante Scegli file utilizzando la dichiarazione seguente

driver.findElement(By.xpath(".//*[@id='photoimg']")).click();

Passo 6) Attendi che appaia il popup di Windows. Il metodo Wait viene utilizzato per gestire il ritardo associato all'apertura del popup di Windows dopo aver cliccato sul pulsante Browse.

s.wait(fileInputTextBox, 20);

Passo 7) Digitare il percorso del file nella casella di testo del file di input e fare clic sul pulsante Apri

s.type(fileInputTextBox, inputFilePath + "Test.docx");
s.click(openButton);

Passo 8) Chiudi il browser

driver.close();

Uscita

Inizialmente, lo script apre il browser Chrome

Clicca sul pulsante 'Scegli file', apparirà la schermata popup del file di Windows. Inserisci i dati nella casella di testo File Input e clicca sul pulsante 'Apri'

La schermata seguente viene visualizzata una volta completato il caricamento del file e chiude il browser

Poiché la corrispondenza dipende dai pixel, è necessario ricatturare ogni immagine di riferimento ogni volta che l'interfaccia viene modificata. Questa fragilità è il motivo per cui i team riservano Sikuli ai popup. Gestione dei file WebDriver standard non posso raggiungere.

DOMANDE FREQUENTI