Sikuli Tutorial for Selenium Automaatio
Krishna Rungta
Missä Sikuli on mukana Selenium?
Sikuli on avoimen lähdekoodin GUI-pohjainen testiautomaatiotyökalu. Sitä käytetään pääasiassa vuorovaikutukseen web-sivujen elementtien kanssa ja ikkunoihin perustuvien ponnahdusikkunoiden käsittelyyn. Sikuli käyttää "Image Recognition"- ja "Control GUI" -tekniikkaa vuorovaikutuksessa web-sivujen ja ikkunoiden ponnahdusikkunoiden kanssa. Sikulissa kaikki verkkoelementit otetaan kuvina ja tallennetaan projektin sisään.
Kuinka käyttää Sikulia Selenium Web-ohjain
Sikuli voidaan integroida seleeni-webdriveriin Sikuli JAR -tiedoston avulla.
Alla oleva sekvenssi on luettelo vaiheista, joilla Sikuli määritetään seleeni-webdriverin kanssa.
Vaihe 1) Lataa Sikuli JAR -tiedosto alla olevasta URL-osoitteesta ja pura ZIP-tiedoston sisältö kansioon.
Vaihe 2) Luo uusi JAVA-projekti sisään Eclipse ja lisää JAR-tiedosto rakennuspolkuun sekä seleenipurkkitiedostot napsauttamalla projektia hiiren kakkospainikkeella -> Rakennapolku -> Määritä rakennuspolku
Kun olet lisännyt JAR-tiedoston projektin rakennuspolkuun, voit käyttää Sikulin tarjoamia luokkia.
Näytön luokka Sikulissa
Näyttöluokka on perusluokat kaikille Sikulin tarjoamille menetelmille. Näyttöluokka sisältää ennalta määritetyt menetelmät kaikille yleisesti suoritetuille toiminnoille näyttöelementeillä, kuten napsautus, kaksoisnapsauttaminen, syötteen antaminen tekstiruutuun, hiiri jne. Alla on luettelo Screen-luokan tarjoamista yleisesti käytetyistä menetelmistä.
| Menetelmä | Tuotetiedot | Syntaksi |
|---|---|---|
| Napauta | Tällä menetelmällä napsautetaan elementtiä näytöllä käyttämällä parametrina kuvan nimeä. | Näyttö s = uusi Näyttö();
s.click("QA.png"); |
| doubleClick | Tätä menetelmää käytetään elementin kaksoisnapsautukseen. Se hyväksyy kuvan nimen parametrina. | Näyttö s = uusi Näyttö();
s.doubleClick("QA.png"); |
| Tyyppi | Tätä menetelmää käytetään syöttämään elementille arvo. Se hyväksyy parametreiksi lähetettävän kuvan nimen ja tekstin. |
s.type("QA.png","TEKSTI"); |
| Häilyä | Tätä menetelmää käytetään viemään hiiri elementin päälle. Se hyväksyy kuvan nimen parametrina. |
s.hover("QA.png"); |
| Löytää | Tätä menetelmää käytetään tietyn elementin etsimiseen näytöltä. Se hyväksyy kuvan nimen parametrina. |
s.find("QA.png"); |
Malliluokka Sikulissa
Kuvioluokkaa käytetään yhdistämään kuvatiedosto lisämääritteillä elementin yksilöimiseksi. Se ottaa kuvan polun parametrina.
Pattern p = uusi kuvio ("Kuvan polku");
Seuraavat ovat Pattern-luokan yleisimmin käytetyt menetelmät.
| Menetelmä | Tuotetiedot | Syntaksi |
|---|---|---|
| getFileName | Palauttaa Pattern-objektin sisältämän tiedostonimen. |
Pattern p = uusi kuvio ("D:\Demo\QA.png"); Merkkijono tiedostonimi = p.getFileName(); |
| samankaltainen | Tämä menetelmä palauttaa uuden Pattern-objektin, jonka samankaltaisuus on asetettu määritettyyn arvoon. Se hyväksyy parametriksi samankaltaisuusarvon välillä 0 - 1. Sikuli etsii kaikki elementit, jotka kuuluvat määritetylle samankaltaisuusalueelle ja palauttaa uuden kuvioobjektin. |
Kuvio p1 = p.similar(0.7f); |
| Tarkka | Tämä menetelmä palauttaa uuden malliobjektin, jonka samankaltaisuus on asetettu arvoon 1. Se etsii vain määritetyn elementin täsmällistä vastaavuutta. |
Kuvio p1 = p.tarkka(); |
Koodiesimerkki tiedoston lataamiseen Sikulilla
Alla oleva koodi selittää Sikulin käytön tiedostojen lataamiseen Firefox.
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();
}
}
Koodin selitys:
Vaihe 1) Ensimmäinen lause sisältää ohjaimen suoritettavan polun asettamisen kromille.
System.setProperty("webdriver.chrome.driver", "D:\\ chromedriver.exe");
Vaihe 2) Käytä näytönkaappaustyökalua, kuten Snipping Tool ottaaksesi kuvakaappauksia Windowsin ponnahdusikkunasta 'FileTextBox' ja 'Avaa'-painike.
Tältä kuvakaappauksen pitäisi näyttää: -
Windowsin tiedostojen syöttötekstiruudun ja avauspainikkeen kuvat tallennetaan 'FileTextiinBox.PNG ja OpenButton.PNG.
Sikuli käyttää kuvantunnistustekniikkaa ruudun elementtien tunnistamiseen. Se löytää elementtejä näytöltä pelkästään niiden kuvien perusteella.
Esimerkki: Jos haluat automatisoida muistilehtiön avaamisen, sinun on tallennettava muistilehtiön työpöydän kuvakkeen kuva PNG-tiedostoon ja suoritettava sitä napsauttamalla.
Meidän tapauksessamme se tunnistaa tiedoston syöttötekstiruudun ja avaa painikkeen Windows ponnahdusikkuna tallennettujen kuvien avulla. Jos näytön resoluutio muuttuu kuvankaappauksesta testiskriptin suorittamiseen, Sikulin käyttäytyminen olisi epäjohdonmukaista. Siksi on aina suositeltavaa suorittaa testiskripti samalla resoluutiolla, jolla kuvat on otettu. Kuvien pikselikoon muutos johtaa siihen, että Sikuli heittää FindFailed-poikkeuksen.
Vaihe 3) Seuraavat lauseet sisältävät objektien luomisen Screen- ja Pattern-luokille. Luo uusi näyttöobjekti. Aseta Pattern-objektin parametriksi ladattavan tiedoston polku.
Screen s = new Screen(); Pattern fileInputTextBox = new Pattern(filepath + "FileTextBox.PNG"); Pattern openButton = new Pattern(filepath + "OpenButton.PNG");
Vaihe 4) Alla olevat lausunnot koskevat Chrome-selaimen avaamista URL-osoitteella: https://demo.guru99.com/test/image_upload/index.php
driver = new ChromeDriver();
driver.get("https://demo.guru99.com/test/image_upload/index.php");
Yllä oleva URL-osoite on demosovellus, joka osoittaa tiedostojen lataustoiminnon.
Vaihe 5) Napsauta Valitse tiedosto -painiketta käyttämällä alla olevaa lauseketta
driver.findElement(By.xpath(".//*[@id='photoimg']")).click();
Vaihe 6) Odota, että ikkunan ponnahdusikkuna tulee näkyviin. Odotusmenetelmää käytetään ikkunoiden avaamiseen liittyvän viiveen käsittelemiseen selauspainikkeen painamisen jälkeen.
s.wait(fileInputTextBox, 20);
Vaihe 7) Kirjoita tiedoston polku syöttötiedoston tekstiruutuun ja napsauta Avaa-painiketta
s.type(fileInputTextBox, inputFilePath + "Test.docx"); s.click(openButton);
Vaihe 8) Sulje selain
driver.close();
lähtö:
Aluksi komentosarja avaa Chrome-selaimen
Napsauttamalla 'Valitse tiedosto' -painiketta Windows-tiedoston ponnahdusikkuna tulee näkyviin. Syöttää tiedot File Input -tekstiruutuun ja napsauttaa 'Avaa'-painiketta
Alla oleva näyttö tulee näkyviin, kun tiedoston lataus on valmis ja selain suljetaan
Yhteenveto
Sikulia käytetään helposti web-sivujen flash-objektien ja ikkunoiden ponnahdusikkunoiden käsittelyyn. Sikuli on paras käyttää, kun käyttöliittymän elementit eivät vaihda usein. Tämän haitan vuoksi Sikuli on automaatiotestauksen näkökulmasta vähemmän etusijalla muihin viitekehykseen verrattuna, kuten Robot ja AutoIT.
