-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
96 lines (62 loc) · 3.21 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
This project is an example of building a test automation framework using WebDriver w Java, TestNG, Gradle with InteliJ or Eclipse.
It extends the basic tutorial found on the Selenium Wiki and runs a couple of tests against http://vanq.org
http://code.google.com/p/selenium/wiki/GettingStarted
http://code.google.com/p/selenium/wiki/PageObjects
There are a couple of key concepts demonstrated in this project that will help you get started
- Switching the navigation of the tests from one page object to another
- Abstracting the test setup into a BaseTest class
- Using TestNG and Gradle to run the tests
Clone the GitHub repo
---------------------
git clone [email protected]:iainrose/vanq-java.git
Creating the IDE project
------------------------
InteliJ
cd ~/<checkout dir>/vanq-java
./gradlew idea
Open the generated vanq-java.ipr file and you're good to go. All your dependencies will be automatically resolved and ready to use.
Eclipse
cd ~/<checkout dir>/vanq-java
./gradlew eclipse
If you don't want to use Gradle you can also do this manually, as explained here by Simon Stewart aka The WebDriver guy.
http://www.youtube.com/watch?v=Eft3qGFoqwE
If you want to update the version of Selenium or TestNG you are using just update the version numbers in build.gradle and rerun the above commands to regenerate your project.
Writing the Tests
-----------------
I find using a Test Driven (Test) Development approach works well here.
- Write the test
- Create the Page Object Methods
- Create the Page Object Locators
- Run the test and debug until it passes
Note also that the tests don't know anything about WebDriver .... keep it that way!
Building the Page Objects
-------------------------
You can use the PageFactory helper to define your locators
http://code.google.com/p/selenium/wiki/PageFactory
However, I prefer to store them as By objects
There are several reasons for this:
- You control when the WebElement will get looked up each time you use the locator which can help avoid stale element exceptions
- You can reuse your locators in methods that assert the presence or absence of a WebElement (return driver.findElements(yourByObjectLocator).size() > 0)
- You can reuse your locators in all the canned ExpectedConditions waits
- Personally I think they look cleaner in the code
Running the tests via the IDE
-----------------------------
Right click on the test and select 'run' or 'debug'
Running the tests using Gradle
------------------------------
Unless you have Gradle installed, you'll need to use the Gradle wrapper which is included in the project
./gradlew, or gradle.bat on Windows
To run all tests (uses Firefox by default)
./gradlew clean test
To run a single test class
./gradlew clean test -Dtest.single="MeetingsPageTest"
To run only tests belonging to the "smoke" group (as defined in the includeSmokeGroup task in build.gradle)
./gradlew clean includeSmokeGroup
To run only tests not belonging to the "content" group (as defined in the excludeContentGroup task in build.gradle)
./gradlew clean excludeContentGroup
To run tests in Chrome
./gradlew clean test -DBROWSER=chrome
To run tests in IE
gradle.bat clean test -DBROWSER=internetExplorer
All and any feedback welcome and appreciated, I'm still learning too.
@iainrose