Tutorial de Sikuli para Selenium Automatización

¿En qué está Sikuli? Selenium?

Sikuli es una herramienta de automatización de pruebas basada en GUI de código abierto. Se utiliza principalmente para interactuar con elementos de páginas web y manejar ventanas emergentes. Sikuli utiliza la técnica de “Reconocimiento de imágenes” y “GUI de control” para interactuar con elementos de páginas web y ventanas emergentes. En Sikuli, todos los elementos web se toman como imágenes y se almacenan dentro del proyecto.

⚠️ Nota sobre el nombre: El proyecto se mantiene hoy como SikuliX, publicado en Maven Central como com.sikulix:sikulixapiLos nombres de las clases que aparecen a continuación no han sufrido cambios.

Cómo utilizar Sikuli con Selenium controlador web

Sikuli se puede integrar con Selenium WebDriver utilizando el archivo JAR de Sikuli, en los dos pasos que se indican a continuación.

Paso 1) Descargar El archivo JAR de Sikuli que se encuentra a continuación URL, y extract el contenido del archivo ZIP a una carpeta.

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

Paso 2) Cree un nuevo proyecto JAVA en Eclipse y agregue el archivo JAR a la ruta de compilación, junto con los archivos jar de Selenium usando clic derecho en el proyecto -> Ruta de compilación -> Configurar ruta de compilación, como se muestra a continuación.

Una vez que hayas añadido el archivo JAR a la ruta de compilación del proyecto, podrás usar las clases proporcionadas por Sikuli. Un proyecto Maven también puede declarar el mismo artefacto como dependencia.

Clase de pantalla en Sikuli

La clase Screen es la clase base para todos los métodos que ofrece Sikuli. Contiene métodos predefinidos para las operaciones más comunes en los elementos de la pantalla, como clic, doble clic, introducir texto en un cuadro de texto, pasar el ratón por encima, etc. A continuación, se muestra la lista de métodos de uso común que ofrece la clase Screen.

Clase de patrón en Sikuli

Mientras que Screen actúa sobre un nombre de imagen simple, la clase Pattern se utiliza para asociar el archivo de imagen con atributos adicionales que identifican de forma única el elemento. Recibe como parámetro la ruta de la imagen.

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

Los siguientes son los métodos más comúnmente utilizados de la clase Patrón.

Code Ejemplo de carga de archivos usando Sikuli

El siguiente código explica el uso de Sikuli para la carga de archivos en 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 Explicación

Paso 1) La primera declaración implica configurar la ruta ejecutable del controlador para Chrome.

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

⚠️ Nota de versión: Selenium 4 resuelve el binario del controlador a través de Selenium Gerente, esta línea ahora es opcional. Se mantiene tal como la escribió el autor original.

Paso 2) Utilice una herramienta de captura de pantalla como Snipping Tool para tomar capturas de pantalla de la ventana emergente 'FileText'Boxy el botón 'Abrir', como se muestra a continuación.

Así es como debería verse tu captura de pantalla:

Las imágenes para el cuadro de texto de entrada de archivos de Windows y el botón Abrir se almacenan en 'FileText'Box.PNG’ y ‘OpenButton.PNG’.

Ejemplo: si desea automatizar la operación de apertura del Bloc de notas, debe almacenar la imagen de un icono del escritorio para el Bloc de notas en un archivo PNG y realizar una operación de clic en él.

En nuestro caso, reconoce el cuadro de texto de entrada de archivo y el botón Abrir en Windows ventana emergente que utiliza las imágenes almacenadas. Si la resolución de la pantalla cambia desde la captura de la imagen hasta la ejecución del script de prueba, el comportamiento de Sikuli sería inconsistente. Por lo tanto, siempre es recomendable ejecutar el script de prueba con la misma resolución con la que se capturan las imágenes. El cambio en el tamaño de píxel de las imágenes hará que Sikuli lance una excepción FindFailed.

Paso 3) Las siguientes declaraciones incluyen la creación de objetos para las clases Pantalla y Patrón. Crea un nuevo objeto de pantalla. Establezca la ruta del archivo que desea cargar como parámetro para el objeto Patrón.

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

Paso 4) Las siguientes declaraciones implican abrir el navegador Chrome con el URL de una aplicación de carga de archivos de demostración: https://demo.guru99.com/test/image_upload/index.php

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

Paso 5) Haga clic en el botón elegir archivo usando la siguiente declaración

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

Paso 6) Espere a que aparezca la ventana emergente. El método de espera se utiliza para controlar la demora asociada con la apertura de la ventana emergente después de hacer clic en el botón Explorar.

s.wait(fileInputTextBox, 20);

Paso 7) Escriba la ruta del archivo en el cuadro de texto del archivo de entrada y haga clic en el botón Abrir

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

Paso 8) Cerrar el navegador

driver.close();

Resultado

Inicialmente, el script abre el navegador Chrome.

Haga clic en el botón "Seleccionar archivo" y aparecerá la ventana emergente de archivos de Windows. Ingrese los datos en el cuadro de texto de entrada de archivo y haga clic en el botón "Abrir".

La siguiente pantalla se muestra una vez que se completa la carga del archivo y se cierra el navegador.

Dado que la coincidencia depende de los píxeles, es necesario volver a capturar cada imagen de referencia cada vez que se rediseñe la interfaz. Esta fragilidad es la razón por la que los equipos reservan Sikuli para ventanas emergentes. Manejo de archivos WebDriver estándar no puedo alcanzar.

Preguntas Frecuentes