Classe de robots dans Selenium Pilote Web

Qu'est-ce que la classe de robot Selenium?

Classe de robots in Selenium est utilisé pour permettre des tests automatisés pour les implémentations de Java plate-forme. Il génère des événements d'entrée dans les systèmes natifs pour l'automatisation des tests, les démos auto-exécutables et d'autres applications où les utilisateurs ont besoin de contrôler la souris et le clavier. La classe Robot est facile à mettre en œuvre et peut être facilement intégrée à un framework automatisé.

Pourquoi la classe Robot ?

Classe de robots est utilisé dans Selenium parce que, dans certains Selenium tests d'automatisation, les utilisateurs ont besoin de contrôler le clavier ou la souris pour interagir avec les fenêtres du système d'exploitation comme les fenêtres contextuelles de téléchargement, les fenêtres contextuelles d'impression, etc. et les applications natives comme le bloc-notes, la calculatrice, etc. Selenium Webdriver ne peut pas gérer ces pop-ups/applications, donc dans Java Dans la version 1.3, une classe de robots a été introduite et peut gérer les pop-ups/applications du système d'exploitation.

Documentation sur les classes de robots

Le Documentation sur les classes de robots in Selenium aide les utilisateurs à comprendre la définition de base, la syntaxe et l'utilisation de toutes les méthodes et fonctions disponibles dans la classe robot dans Java Forfait AWT. Les utilisateurs peuvent consulter la documentation sur le Oracle site. Les utilisateurs peuvent également créer eux-mêmes la documentation sur leur ordinateur local.

Pour créer la documentation sur la machine locale, suivez les étapes ci-dessous :

Étape 1) Vous trouverez le fichier src.zip dans le dossier JDK. Copiez src.zip et extracla même chose dans un autre dossier ou répertoire (par exemple D: ou E: )

Étape 2) ExtracAccédez au dossier src et naviguez jusqu'à (chemin jusqu'au dossier src)./src/java/awt

Étape 3) Copiez l'emplacement actuel du dossier awt et ouvrez l'invite de commande.

Étape 4) Dans cmd, changez l'emplacement de votre répertoire actuel en dossier awt et tapez « javadoc *.java » comme indiqué ci-dessous.

Attendez un moment que le système traite, une fois terminé, vous verrez quelques fichiers HTML dans le dossier awt.

Étape 5) Ouvrir index.html

Étape 6) Voici la documentation complète du package awt, dans la barre de navigation de gauche, cliquez sur le lien hypertexte « Robot » (voir 1 marqué dans l'image ci-dessous).

Ici, vous pouvez également voir toutes les méthodes et interfaces de Robot Class (voir 2 marqués dans l'image ci-dessus).

Méthodes de classe de robot dans Selenium et utilisation

Les méthodes de classe Robot peuvent être utilisées pour interagir avec les événements clavier/souris tout en automatisant le navigateur. Alternativement AutoIT peut être utilisé, mais son inconvénient est qu'il génère un fichier exécutable (exe) qui ne fonctionnera que sous Windows, ce n'est donc pas une bonne option à utiliser.

Certaines méthodes couramment utilisées de Robot Class lors de l’automatisation Web :

Méthode 1 : keyPress() :

robot.keyPress(KeyEvent.VK_DOWN) : Cette méthode en appuyant sur la touche fléchée vers le bas du clavier

Méthode 2 : mousePress() :

robot.mousePress(InputEvent.BUTTON3_DOWN_MASK) : Cette méthode appuiera sur le clic droit de votre souris.

Méthode 3 : mouseMove() :

robot.mouseMove(point.getX(), point.getY()) : cela déplacera le pointeur de la souris vers les coordonnées X et Y spécifiées.

Méthode 4 : keyRelease() :

robot.keyRelease(KeyEvent.VK_DOWN) : Cette méthode avec la touche fléchée vers le bas du clavier

Méthode 5 : mouseRelease() :

robot.mouseRelease(InputEvent.BUTTON3_DOWN_MASK) : Cette méthode libérera le clic droit de votre souris

Exemple de code pour automatiser les cas d'utilisation courants à l'aide de Robot Class

• Prenons l'exemple du site Web http://spreadsheetpage.com/index.php/file/C35/P10/ dans lequel après avoir cliqué sur un élément Web (.//a[@href=contains(text(),'yearly-calendar.xls']), une fenêtre contextuelle de téléchargement du système d'exploitation apparaît.

• Pour gérer cela, nous utilisons la classe Robot (en créant une instance de Robot Class dans votre code, par exemple Robot robot = nouveau Robot()) . La classe Robot est présente dans le package AWT du JDK.

Touche du clavier	Méthode
Pour appuyer sur la touche fléchée vers le bas	nous utilisons (robot.keyPress(KeyEvent.VK_DOWN))
Pour appuyer sur la touche TAB	nous utilisons (robot.keyPress(KeyEvent.VK_TAB))
Pour appuyer sur la touche Entrée	nous utilisons (robot.keyPress(KeyEvent.VK_ENTER))

Exemple de classe de robot dans Selenium

import java.awt.AWTException;	
import java.awt.Robot;	
import java.awt.event.KeyEvent;	
import org.openqa.selenium.By;	
import org.openqa.selenium.WebDriver;	
import org.openqa.selenium.firefox.FirefoxDriver;	

class Excercise1 {	

      public static void main(String[] args) throws AWTException, InterruptedException {	
           WebDriver driver = new FirefoxDriver();	
           driver.get("http://spreadsheetpage.com/index.php/file/C35/P10/"); // sample url	
           driver.findElement(By.xpath(".//a[@href=contains(text(),'yearly-calendar.xls')]")).click();	
           Robot robot = new Robot();  // Robot class throws AWT Exception	
           Thread.sleep(2000); // Thread.sleep throws InterruptedException	
           robot.keyPress(KeyEvent.VK_DOWN);  // press arrow down key of keyboard to navigate and select Save radio button	
           
           Thread.sleep(2000);  // sleep has only been used to showcase each event separately	
           robot.keyPress(KeyEvent.VK_TAB);	
           Thread.sleep(2000);	
           robot.keyPress(KeyEvent.VK_TAB);	
           Thread.sleep(2000);	
           robot.keyPress(KeyEvent.VK_TAB);	
           Thread.sleep(2000);	
           robot.keyPress(KeyEvent.VK_ENTER);	
       // press enter key of keyboard to perform above selected action	
     }	 
 }

Regardez cette vidéo pour le voir en action

Comment exécuter le code de la classe Robot en utilisant TestNG

Puisque vous connaissez maintenant les méthodes de base de Robot Class, comprenons donc quelques méthodes plus complexes –

Supposons que vous ne vouliez pas utiliser le méthode de clic pour cliquer sur un élément Web.

Dans de tels cas, vous pouvez utiliser la méthode mouseMove de la classe Robot.

Étape 1) La méthode mouseMove prend les coordonnées x et y comme paramètres comme robot.mouseMove(630, 420) où 630 indique l'axe des x et 420 indique l'axe des y. Ainsi, cette méthode déplacera le pointeur de votre souris de l’emplacement actuel vers le point d’intersection x et y mentionné.

Étape 2) Ensuite, nous devons appuyer sur le bouton de la souris. Nous pouvons utiliser la méthode sourisPresse comme robot.mousePress(InputEvent.BUTTON1_DOWN_MASK) .

Étape 3) Après avoir appuyé, la souris doit être relâchée. On peut utiliser robot.mouseRelease(InputEvent.BUTTON1_DOWN_MASK) afin de relâcher le clic gauche d'une souris.

Exécuter du code à l'aide de testNG :

Exécuter du code en utilisant Tester nécessite une dépendance Maven de testNG ou une bibliothèque référencée de TestNG fichier jar.

TestNG dépendance maven :

<dependency>	
  <groupId>org.testng</groupId>
  <artifactId>testng</artifactId>	
  <version>6.1.1</version>	
</dependency>

Après avoir ajouté la dépendance Maven ou le fichier jar. Vous devez importer l'annotation de test de testNG. Une fois que tout est fait, faites un clic droit sur le code du programme et cliquez sur Exécuter en tant que, puis cliquez sur TestNG… et vous constaterez que le code démarrera son exécution à l’aide de l’API testNG.

Voici le code

import java.awt.AWTException;	
import java.awt.Robot;	
import java.awt.event.InputEvent;	
import java.awt.event.KeyEvent;	
import org.openqa.selenium.WebDriver;	
import org.openqa.selenium.firefox.FirefoxDriver;	
import org.testng.annotations.Test;	

public class Excersise1 {	

    @Test	
    public static void  execution() throws InterruptedException, AWTException {
        WebDriver driver = new FirefoxDriver();	
        driver.manage().window().maximize();	
        driver.get("http://spreadsheetpage.com/index.php/file/C35/P10/"); // sample url	
        Robot robot = new Robot();	
        robot.mouseMove(630, 420); // move mouse point to specific location	
        robot.delay(1500);        // delay is to make code wait for mentioned milliseconds before executing next step	
        robot.mousePress(InputEvent.BUTTON1_DOWN_MASK); // press left click	
        robot.mouseRelease(InputEvent.BUTTON1_DOWN_MASK); // release left click	
        robot.delay(1500);	
        robot.keyPress(KeyEvent.VK_DOWN); // press keyboard arrow key to select Save radio button	
        Thread.sleep(2000);	
        robot.keyPress(KeyEvent.VK_ENTER);	
        // press enter key of keyboard to perform above selected action	
    }	
}	

Regardez cette vidéo pour le voir en action

Avantages de la classe robot

1. La classe Robot peut simuler un événement clavier et souris
2. Robot Class peut aider au téléchargement/téléchargement de fichiers lors de l'utilisation du pilote Web Selenium
3. Robot Class peut facilement être intégré au cadre d'automatisation actuel (mot clé, basé sur les données ou hybride)

Inconvénients de la classe robot

Le framework robot présente quelques inconvénients mentionnés ci-dessous :

1. L'événement mot-clé/souris ne fonctionnera que sur l'instance actuelle de Window. Par exemple, supposons qu'un code exécute un événement de classe de robot et que pendant l'exécution du code, l'utilisateur s'est déplacé vers un autre écran, un événement mot-clé/souris se produira sur cet écran.
2. La plupart des méthodes telles que mouseMove dépendent de la résolution de l'écran, il est donc possible que le code fonctionnant sur une machine ne fonctionne pas sur une autre.

Résumé

La classe Robot du package AWT est utilisée pour générer des événements clavier/souris pour interagir avec les fenêtres du système d'exploitation et les applications natives.

L'objectif principal de Robot est de prendre en charge le projet de tests automatisés Selenium intégré Java