Writing System Tests for Joomla! - Part 2 - Revision history

Dextercowley: add case-insensitive example

2011-07-09T20:55:48Z

add case-insensitive example

Dextercowley: add 2-attribute example

2010-10-11T23:27:30Z

add 2-attribute example

Dextercowley: fix typo

2010-07-05T21:09:34Z

fix typo

Dextercowley: add xpath links

2010-07-05T18:58:03Z

add xpath links

Dextercowley: add xpath information

2010-07-05T18:50:24Z

add xpath information

Dextercowley: add one more xpath example

2010-06-20T02:13:42Z

add one more xpath example

Dextercowley: Testing for Text in Tables

2010-06-19T17:47:41Z

Testing for Text in Tables

Dextercowley: remove empty section

2010-06-19T17:06:44Z

remove empty section

Dextercowley: /* Using XPath for Selecting Elements */

2010-06-10T16:55:06Z

‎Using XPath for Selecting Elements

Dextercowley: Using XPath first examples

2010-06-10T02:56:43Z

Using XPath first examples

@@ Line 336: / Line 336: @@
 :PHP Code to Click: <source lang="PHP">$this->click("//tr/td/a[contains(text(), 'Modules')]");</source>
 :Comment: In many cases, using a partial text match is preferable to an exact text match, since it is less likely to be affected by minor changes in the layouts.
 ;Finding and Element Based on Values of Two Attributes

@@ Line 336: / Line 336: @@
 :PHP Code to Click: <source lang="PHP">$this->click("//tr/td/a[contains(text(), 'Modules')]");</source>
 :Comment: In many cases, using a partial text match is preferable to an exact text match, since it is less likely to be affected by minor changes in the layouts.
 ;Finding a Link or Button in Table based on Text in the Same Row

@@ Line 323: / Line 323: @@
 :Explanation: Find the first button element that contains an "@onclick" attribute that is equal to 'component.save'.
 :PHP Code to Click: <source lang="PHP">$this->click("//button[contains(@onclick, 'component.save')]");</source>
-:Comment: Using a partial text match can be handy when an attribute has a very long value or if they value can change (for example, based on row number).
+:Comment: Using a partial text match can be handy when an attribute has a very long value or if the value can change (for example, based on row number).
 ;Finding an Element Based on Partial Text Match of All Contained Text

@@ Line 380: / Line 380: @@
 * For writing a more advanced Selenium testcase: [[Intermediate_Selenium_Example]]
 * The Selenium website has excellent documentation for using the Selenium IDE and Selenium RC: [http://seleniumhq.org/docs/ Selenium documentation].
-* XPath tutorial with examples: [http://www.w3schools.com/xpath/default.asp]
+* XPath tutorial with examples: [http://www.w3schools.com/xpath W3Schools XPath Tutorial]
 [[Category:Bug Squad]][[Category:Development]][[Category:Testing]][[Category:Automated Testing]]

@@ Line 380: / Line 380: @@
 * For writing a more advanced Selenium testcase: [[Intermediate_Selenium_Example]]
 * The Selenium website has excellent documentation for using the Selenium IDE and Selenium RC: [http://seleniumhq.org/docs/ Selenium documentation].
 [[Category:Bug Squad]][[Category:Development]][[Category:Testing]][[Category:Automated Testing]]

@@ Line 351: / Line 351: @@
 (see [[Selenium_Test_Case_Methods|Selenium Test Case Methods]])
-== Methods for Identifying Elements ==
 == See Also ==

@@ Line 314: / Line 314: @@
 ;Finding an Element Based on Exact Value of an Attribute
-:XPath Example: <code>//button[contains(@onclick, 'component.save')]</code>
+:XPath Example: <code>//li[@id='toolbar-apply']/a/span</code>
-:Explanation: Find the first button element that contains an "@onclick" attribute that is equal to 'component.save'.
+:Explanation: Find the first li element with @id attribute that is equal to 'toolbar-apply'.
-:PHP Code to Click: <source lang="PHP">$this->click("//button[contains(@onclick, 'component.save')]");</source>
+:PHP Code to Click: <source lang="PHP">$this->click("//li[@id='toolbar-apply']/a/span");</source>
 ;Finding an Element Based on Partial Match of an Attribute
@@ Line 322: / Line 323: @@
 :Explanation: Find the first button element that contains an "@onclick" attribute that is equal to 'component.save'.
 :PHP Code to Click: <source lang="PHP">$this->click("//button[contains(@onclick, 'component.save')]");</source>
-;Finding an Element Based on Partial Text Match
+;Finding an Element Based on Partial Text Match of All Contained Text
 :XPath Example:<code> //tr[contains(., 'Modules')]/td/a</code>
-:Explanation: Find the first tr element that contains the text 'Modules', then find the first td element that contains an anchor (a).
+:Explanation: Find the first tr element that contains the text 'Modules' anywhere inside this element (including in child elements), then find the first td element that contains an anchor (a).
 :PHP Code to Click: <source lang="PHP">$this->click("//tr[contains(., 'Modules')]/td/a");</source>
 == Tips & Tricks ==

← Older revision		Revision as of 02:56, 10 June 2010
Line 305:		Line 305:

	== Frequently Asked Questions ==		== Frequently Asked Questions ==
		+
		+	== Using XPath for Selecting Elements ==
		+	When creating system tests, you need to be able to identify specific HTML elements on the page being tested. In some cases, you want to click on a link or a button. In other cases, you want to test that the elements are shown correctly. Or you may need to fill in a form. In all of these cases, a key aspect is identifying the correct element.
		+
		+	Selenium uses [http://en.wikipedia.org/wiki/Xpath XPath] as one way to find and work with HTML elements. When you record a test, this is often done for you. However, as you work with more complicated tests, it is very helpful to understand a little bit about how to use XPath, especially as it relates to specific situations in Joomla.
		+
		+	This section documents some examples of using XPath for specific situations in Joomla.
		+
		+	;Finding an Element Based on Exact Value of an Attribute
		+	:XPath Example: <code>//button[contains(@onclick, 'component.save')]</code>
		+	:Explanation: Find the first button element that contains an "@onclick" attribute that is equal to 'component.save'.
		+	:PHP Code to Click: <source lang="PHP">$this->click("//button[contains(@onclick, 'component.save')]");</source>
		+
		+	;Finding an Element Based on Partial Match of an Attribute
		+	:XPath Example: <code>//button[contains(@onclick, 'component.save')]</code>
		+	:Explanation: Find the first button element that contains an "@onclick" attribute that is equal to 'component.save'.
		+	:PHP Code to Click: <source lang="PHP">$this->click("//button[contains(@onclick, 'component.save')]");</source>
		+
		+	;Finding an Element Based on Partial Text Match
		+	:XPath Example:<code> //tr[contains(., 'Modules')]/td/a</code>
		+	:Explanation: Find the first tr element that contains the text 'Modules', then find the first td element that contains an anchor (a).
		+	:PHP Code to Click: <source lang="PHP">$this->click("//tr[contains(., 'Modules')]/td/a");</source>

	== Tips & Tricks ==		== Tips & Tricks ==