Selenium Commands For Automation Testing

Selenium Commands For Automation Testing

 

一、Element Locators(定位器)

• id=id

id locator (Select the element with the specified @id attribute in HTML).

• name=name

name locator(Select the first element of the same @name attribute elements in HTML).

• identifier=id

identifier locator (First,select the element with the specified @id attribute in HTML.IF it is not extant,then Select the first element of the same @name attribute elements in HTML).

 

• dom=javascriptExpression

dom locator (Using javascriptExpression locate the element of HTML. Note:must start by 'document').

 

Example:

        dom=document.forms['myForm'].myDropdown

        dom=document.images[56]

• xpath=xpathExpression

xpath locator (Locate the element in HTML by XPath. Note:must start by '//')

 

Example:

        xpath=//img[@alt='The image alt text']

        xpath=//table[@id='table1']//tr[4]/td[2]

• link=textPattern

link locator (Select the link (anchor) element which contains text matching the specified pattern).

 

Example:

        link=The link text

• Default

Without an explicit locator prefix, Selenium uses the following default strategies:

              dom, for locators starting with "document."

              xpath, for locators starting with "//"

              identifier, otherwise

 

二、Actions(模仿用户操作)

 

 

Imitate user's actions: Action have two format: 'action' and 'actionAndWait', action will execute at once，but 'actionAndWait' will wait for a setting time to get the response of this action. 'open' can deal latency time itself.

 

 

• click

 

click(elementLocator)

 

- Click link,button,radio or checkbox button.

- If needing latency time for new page response ,please use "waitForPageToLoad"

 

Example:

selenium.click("xpath=//div[@id='dd']");

 

• open

 

open(url)

- Open page using URL in Borwer, the action could receive two formats of relative path and absolute path.

 

Example:

selenium.open("http://www.google.cn");

selenium.open("/login.jsp");

 

• type

 

type(inputLocator, value)

- Imitate the process of user typing, type value to inputLocator.

- also is fit for radio or checkbox.

 

• contextMenu

 

contextMenu(locator)

- Right-click link, button, radio or checkbox button.

 

三、Execute JavaScript(执行JS脚本)

 

 

Launch page, then using selenium Server execute JavaScripte code for some useful function.

 

 

• getEval

 

getEval(String script)

- script: some JavaScript code string.

- getEval: execute script and get the return value.

 

Example:

selenium.getEval("return document.getElementById('test').attribute('value');");

 

 

四、Execute Flex Script(执行Flex脚本)

 

 

 

 

Launch page, then using selenium Server execute JavaScripte code to call Flex function APIs.

 

 

• getEval

 

getEval(String script)

--Precondition: The flash object is in current executing page and this flash has function APIs.

--First: Using javascript DOM find the locator of flash object id.

- Second:         Exectue the function of Flex function APIs of this object locator.

- Third:         GetEval function execute script and get the return value.

 

Example:

String text = "selenium.browserbot.getCurrentWindow().document.getElementById('testFlash').addNode('nodename','parentNodeName','true');";

selenium.getEval(text);

 

 

五、Using XPath(如何使用XPath定位元素)

 

 

Show some useful method to locator element using XPath. 

 

 

• Don't using id locator unless the id of this element is stable or you can't find other ways.

 

Example: 

selenium.click("xpath=//div[@id='test']");

(If the id is not stable, your code is not safe.)

 

• Common useful Path Expression

nodename	Locate all children nodes of this node
/	Locate all node for root node
//	Locate node from current select node, don't care about the location of selected node.
.	Choice current selected node
..	Choice parent node of current selected node
@	Locate node using attribute

 

 

 

Example:

 

booknode	Locate all children nodes of the node named 'booknode'
/booknode	Locate root node named 'booknode'
//book	Locate all node named 'book', don't care about the location of selected node.
//book[@value='1']	Locate node named 'book' and attribute of value equal 1.

 

 

• Useful function of location

 

--text(): Return text value of the element. Like <span>ddd</span>, return ddd.

--contains(String A, String B): If A contains B return true, else return false.

 

--last(): Return the last node of choice nodes.

 

Example:

selenium.click("xpath=//div[contains(text(),'Released Projects')]");

(Click the div which text contains 'Released Projects' string.)

 

• Some XPath Instance

 

--First: xpath=//span[contains(text(),'Released Projects')]/../..//img[@class='dijitTreeExpando dijitTreeExpandoClosed']

(Locate an image tag which is a sub node of the parent node of the parent node of span node which text contains 'Released Projects'.)

 

--Second: xpath=//label[@title='level1FolderName']/../../../..//label[@title='level2FolderName']/../../../img

 

--Third:  xpath=//span[@class='dijitDialogTitle' and text()='Users/Groups Filter']

 

 

六、Reference(参考)

 

--W3School:               http://www.w3school.com.cn/xpath/xpath_syntax.asp

--SpringSide:                     http://wiki.springside.org.cn/display/springside/Selenium+Reference

--Selenium Official site:   http://seleniumhq.org/projects/remote-control/