Graphic Selenium Testing Tool

Transcription

1 Graphic Selenium Testing Tool Last modified: 02/06/2014 1

2 Content 1 What can I do with GSTT? Installation Main window Define a new web testing project Define a new test case Manage web testing project Manage test case Manage test case actions Execute web testing project Change system language FAQ

3 1 What can I do with GSTT? (GSTT) is a software application to define, manage and execute web testing projects easily, visually and through the most popular web testing tool: Selenium. Each web testing project consists in many test cases. Each one represents a set of actions over a web page. For example, to search a product in a web online store or to fill and send a register form in a website. With GSTT users can define these actions on the web browser directly. This activity can also be done with Selenium IDE, but GSTT allows the user to define and execute actions not only in Mozilla Firefox, but also in Google Chrome. Every user can define test cases easily with GSTT. They don't need to know how GSTT or Selenium works. Once test cases are defined, users can execute them and GSTT will inform the user if the execution has been successful or not. As we have said, test cases can been defined and executed in different web browsers. Now, GSTT supports: Google Chrome and Mozilla Firefox. To sum up, what can you do with GSTT? Define web testing projects that consist in one or more test cases. Define test cases that consist in a set of actions that a user would do over a website. Define test cases actions through different web browsers: Google Chrome and Mozilla Firefox. Execute test cases actions in different web browsers: Google Chrome and Mozilla Firefox. In conclusion, GSTT is an application that allows you to manage user tests for a web page. It is necessary to highlight that all tests are saved in files, so you have a total portability for your tests. 3

4 2 Installation To install GSTT, follow these steps: Download the ZIP file of the application from GSTT website at SourceForge. Decompress the file in a folder. Check that Java is installed and updated in your computer. Execute the GSTT.jar file to use the application. 4

5 3 Main window Main window 1 A top menu to define projects, open projects, change the system language and to access to the help option. 2 A project explorer to navigate over projects and test cases. 3 A main zone where you will see project information and test cases information. In the image, the main zone is empty because no project is opened. Project bar and test case bar The project bar and the test case bar will allow you to view, modify, delete and execute your projects and test cases easily. 5

6 4 Define a new web testing project 1 Click on project explorer option New project or from top menu: Project > New project 2 Introduce the project name (mandatory) and its description. Select th web browsers that will be used to execute the project (mandatory). Click over Specify path to indicate the project path (mandatory). The project path is the place where the project file will be saved. 3 Once path is indicated through the file explorer and data has been introduced, click over Save to save the project. Once saved, project data will appear in the main zone of the window. Also, the project will appear in the project explorer.! If mandatory data has not been introduced, an error message will appear: 6

7 5 Define a new test case 1 Click on explorer option New test case of your project. You can also click over the same button in your project main window. 2 Introduce the test case name (mandatory) and its description. Select the web browser that will be used to define test case actions (mandatory). Click over Add icon to open a file explorer in order to select a representative icon of the test case. Finally, click over Save. 3 Once saved, test case data will appear in the main zone of the window. The test case will also be added to the project explorer! If a test case with the same name already exists or mandatory data has not been introduced, an error message will appear: 7

8 6 Manage web testing project To view... To view project data, click over its name on the project explorer. If you are viewing one of its test cases, you can also click over the next button of the project bar: If you want to open a project, you have to choose the following top menu option: Project > Open project Once done, project data will appear. A list of project test cases will also appear. To modify... To modify project data, click over the nex button of the project bar: A form will appear. Modify its data and click over Save.! If mandatory data has not been introduced, an error message will appear: 8

9 To close... To close a project, you have to select the option by clicking with a right click over its name in the project explorer. A confirmation dialog will appear. 9

10 7 Manage test case To view... To view test case data, click over its name on the project explorer. If you are viewing its test case bar, you can also click over the following button: Once done, test case data will appear. A list of actions will also appear (if any). To modify... To modify test case data, click over the nex button of the test case bar: A form will appear. Modify its data and click over Save.! If a test case with the same name already exists or mandatory data has not been introduced, an error message will appear: 10

11 To delete... To delete a test case, you have to click over the next button of the test case bar: A confirmation dialog will appear. Click over Yes to delete the test case from project. You can also view, modify and delete test cases from the project main window: 11

12 8 Manage test case actions 1 To start or to continue the definition of test case actions, view its data and click over Start test case or Continue test case (if you have defined actions before). 2 If no actions have been defined yet, you will have to introduce the initial page URL of your test case. Once done, click over Accept. Wait until the web browser is opened and GSTT has changed the main window. You will have to wait for the execution of actions in the web browser (if any).! If an execution error has occured in the web browser (URL does not exist, an action could not be executed, there is not Internet connection,...), an error message will appear.. Check the FAQ section for more details. 12

13 3 Once done, you can do actions over the web browser. These actions will be captured and will appear on the main window.! Remember that there is a limited number of actions that can be captured. If an execution error occurs, the web browser will be closed and an error message will appear. Check the FAQ section for more details. 4 If you want to check the content of a HTML element that you are viewing, click over Check HTML element content. A confirmation dialog will appear. Once you have clicked over Accept, you will have to do a right click over the HTML element you want to check. Once done, in GSTT you will see the checking action captured. You can delete it or modify it by clicking over the appropiate button. 13

14 5 If you want to check the presence of a HTML element that you are viewing, click over Check HTML element presence. A confirmation dialog will appear. Once you have clicked over Accept, you will have to do a right click over the HTML element you want to check. Once done, in GSTT you will see the checking action captured. You can delete it or modify it by clicking over the appropiate button. 6 Once you have finished the definition of test case actions, click over Save and continue or Save and get out. If you choose the second option, thw web browser will be closed and you will see the actions captured on the test case main window. In both options a confirmation dialog will appear. 14

15 9 Execute web testing project 1 To execute a project, click over the next button of the project bar:! If the project has at least one test case with no actions defined, you won't be able to do the execution. 2 Once done, you will see the execution window. Choose the execution mode (check the FAQ section for more details) and the test cases to execute. Then, click over Execute project. 15

16 3 Once done, all test cases will be executed on the web browsers that were chosen for the project execution. Wait until execution finishes. You can abort the execution by clicking over Get out. 4 Once all test cases have been executed, you will see the execution result on the right side. of the window. This result will inform whether all test cases have been executed successfuly or not. In the second case, the test case, action and web browser where the error occured will be indicated. 16

17 10 Change system language 1 To change system language, choose the following top menu option: Help > Change language 2 Once done, a new window will appear. Select the language and click over Accept. Then, a confirmation dialog will appear. Click over Accept and GSTT will be closed. When you open GSTT again, the language system will be the chosen one. 17

18 11 FAQ I can't open or use GSTT. What can I do? If you can't use GSTT, check that the ZIP file is decompressed. Also, check that the drivers folder is present and that you have Java installed and updated. An execution error has occured on the web browser. What happened? If an execution error has occured on the web browser, check that: 1 Internet connection is active. 2 Web browsers are installed in your computer or/and the drivers folder is in the appropiate place. Remember that the drivers folder and the application have to be in the same place. 3 The test case you want to execute has an existing URL. 4 The test case you want to execute has actions defined for only one web domain. For example, if your initial page URL begins with check that all actions have URL's that begin with 5 The GSTT version installed is the latest version available. If you have checked all of these steps but the problem persists, check that the website you want to test has actions that can be captured (see next question for more details). What kind of actions in the web browser can be captured with GSTT? With GSTT you can capture actions that belong to the same web domain. For example, if your initial page URL begins with all actions must have URL's that begin with Actions captured can be: Mouse clicks over web page elements: to follow links, select options,... Write in forms: text boxes,... Also, with GSTT you can check HTML element content and presence. In order to do these actions, you have to select the appropiate option in the application. Then, you have to do a right click over the HTML element you want to check. If you could not find a solution, check the Support section of the GSTT web page of SourceForge. 18

19 What kind of actions in the web browser can NOT be captured with GSTT? With GSTT you cannot capture: Actions executed in different web domains. Actions related to web browser functionalities: refresh a page, go back, open tabs,... TAB and ENTER keys. Some actions done over web animations (see next question for more details). I am doing actions over the web browser, but GSTT does not capture them. What can I do? Remember that GSTT can only capture a limited set of actions. Moreover, some actions done over animations can be captured but can not be executed. GSTT does not capture actions done over Adobe Flash. What kind of web pages can I test with GSTT? With GSTT you can test web pages that have HTML, don't have Adobe Flash and use a limited number of animations. Moreover, your web page should use the same domain over its URL's. What are execution modes? Executions modes inform to GSTT what to do when an error occurs when a project execution is active. These modes can be:: If error, close browser If an error occurs, the web browser will be closed. If error, close browser and execute again until the error If an error occurs, the web browser will be closed. Then, GSTT will open it again in order to execute all test case actions until the action that triggered the error. I could not find a solution. What can I do? If you could not find a solution, check the Support section of the GSTT web page of SourceForge. You can also access it through the following top menu option: Help > View help 19