selenium

Selenium使用介绍

Selenium 是 thoughtworks公司的一个集成测试的强大工具。最近参与了一个系统移植的项目，正好用到这个工具，

把一些使用心得分享给大家，希望大家能多多使用这样的强大的，免费的工具，来保证我们的质量。

Selenium 的文档现存的不少，不过都太简单了。使用Selenium的时候，我更多的是直接去看API文档，好在API不错，

一个一个看，就能找到所需要的 :-) 官方网站：http://www.openqa.org/selenium/

好，下面进入正题！

一、Selenium 的版本

Selenium 现在存在2个版本，一个叫 selenium-core, 一个叫selenium-rc 。

selenium-core 是使用HTML的方式来编写测试脚本，你也可以使用 Selenium-IDE来录制脚本，但是目前Selenium-IDE 只有 FireFox 版本。

Selenium-RC 是 selenium-remote control 缩写，是使用具体的语言来编写测试类。

selenium-rc 支持的语言非常多，这里我们着重关注java的方式。这里讲的也主要是 selenium-rc，因为个人还是喜欢这种 方式 :-)

二、一些准备工作

1、当然是下载 selenium 了，到 http://www.openqa.org/selenium/ 下载就可以了，记得选择selenium-rc 的版本。

2、学习一下 xpath 的知识。有个教程：

http://www.zvon.org/xxl/XPathTutorial/General_chi/examples.html 一定要学习这个，不然你根本看不懂下面的内容！

3、安装 jdk1.5

三、selenium-rc 一些使用方法

在 selenium-remote-control-0.9.0\\server 目录里，我们运行 java -jar

selenium-server.jar

之后你就会看到一些启动信息。要使用 selenium-rc ，启动这个server 是必须的。

当然，启动的时候有许多参数，这些用法可以在网站里看看教程，不过不加参数也已经足够了。

selenium server 启动完毕了，那么我们就可以开始编写测试类了！

我们先有个概念，selenium 是模仿浏览器的行为的，当你运行测试类的时候，你就会发现selenium 会打开一个

浏览器，然后浏览器执行你的操作。

好吧，首先生成我们的测试类：

java 代码

public class TestPage2 extends TestCase { private Selenium selenium;

protected void setUp() throws Exception {

String url = “http://xxx.xxx.xxx.xxx/yyy”; selenium = new DefaultSelenium(\"localhost\SeleniumServer.getDefaultPort

(), \"*iexplore\ selenium.start();

super.setUp(); }

protected void tearDown() throws Exception {

selenium.stop(); super.tearDown(); } }

代码十分简单，作用就是初始化一个 Selenium 对象。其中： url : 就是你要测试的网站

localhost: 可以不是localhost，但是必须是 selenium server 启动的地址 *iexplore : 可以是其它浏览器类型，可以在网站上看都支持哪些。

下面我就要讲讲怎么使用selenium 这个对象来进行测试。

1、测试文本输入框

假设页面上有一个文本输入框，我们要测试的内容是 在其中输入一些内容，然后点击一个按钮，看看页面的是否跳转 到需要的页面。

public void test1() {

selenium.open(\"http://xxx.xxx.xxx/yyy\");

selenium.type(\"xpath=//input[@name='userID']\ selenium.click(\"xpath=//input[@type='button']\"); selenium.waitForPageToLoad(\"2000\");

assertEquals(selenium.getTitle(), \"Welcome\"); }

上面的代码是这个意思：

1、调用 selenium.open 方法，浏览器会打开相应的页面 2、使用 type 方法来给输入框输入文字 3、等待页面载入

4、看看新的页面标题是不是我们想要的。

2、测试下拉框

java 代码

public void test1() {

selenium.open(\"http://xxx.xxx.xxx/yyy\");

selenium.select(\"xpath=//SELECT[@name='SBBUSYO']\ selenium.click(\"xpath=//input[@type='button']\"); selenium.waitForPageToLoad(\"2000\");

assertEquals(selenium.getTitle(), \"Welcome\"); }

可以看到，我们可以使用 select 方法来确定选择下拉框中的哪个选项。 select 方法还有很多用法，具体去看看文档吧。

3、测试check box

java 代码

public void test1() {

selenium.open(\"http://xxx.xxx.xxx/yyy\");

selenium.check(\"xpath=//input[@name='MEICK_000']\"); selenium.click(\"xpath=//input[@type='button']\"); selenium.waitForPageToLoad(\"2000\");

assertEquals(selenium.getTitle(), \"Welcome\"); }

我们可以使用 check 方法来确定选择哪个radio button

4、得到文本框里的文字

java 代码

assertEquals(selenium.getValue(\"xpath=//input[@name='WNO']\"), \"1\");

getValue 方法就是得到文本框里的数值，可不是 getText 方法，用错了可就郁闷了。

5、判断页面是否存在一个元素

java 代码

assertTrue(selenium.isElementPresent(\"xpath=//input[@name='MEICK_000']\")); 一般这个是用来测试当删除一些数据后，页面上有些东西就不会显示的情况。

6、判断下拉框里选择了哪个选项

java 代码

assertEquals(selenium.getSelectedIndex(\"xpath=//SELECT[@name='HATIMING']\"), \"1\");

这个可以用来判断下拉框显示的选项是否是期望的选项。

7、如果有 alert 弹出对话框怎么办？

这个问题弄了挺长时间，可以这样来关闭弹出的对跨框：

java 代码

if(selenium.isAlertPresent()) {

selenium.getAlert(); }

其实当调用 selenium.getAlert() 时，就会关闭 alert 弹出的对话框。

也可以使用 System.out.println(selenium.getAlert()) 来查看对跨框显示的信息。

在测试的时候，有的人会显示许多alert 来查看运行时的数据，那么我们可以用下面的方式来关闭那些 alert:

java 代码

while(selenium.isAlertPresent()) {

selenium.getAlert(); }

8、如何测试一些错误消息的显示？

java 代码

assertTrue(selenium.getBodyText().indexOf(\"错误消息\")>=0);

切记： getBodyText 返回的时浏览器页面上的文字，不回包含html 代码的，如果要显示html 代码，用下面这个:

java 代码

System.out.println(selenium.getHtmlSource());

以上就是最常用的几个方法了，例如 click, type, getValue 等等。

还有就是一定要学习 xpath, 其实xpath 也可以有“与、或、非”的操作：

java 代码

selenium.check(\"xpath=//input[(@name='KNYKBN')and(@value='Y')]\"); 四、其他

selenium 还有更多的用法，例如弹出页面等等。当面对没见过的测试要求时，我最笨的方法就是按照api文档一个一个找， 好在不多，肯定能找到。 之后后续。。。

12:13 | 添加评论 | 阅读评论 (4) | 固定链接 | 写入日志 4月15日 接上

select

select(dropDownLocator, optionSpecifier)

- 根据optionSpecifier选项选择器来选择一个下拉菜单选项

- 如果有多于一个选择器的时候，如在用通配符模式，如\"f*b*\或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值 select dropDown Australian Dollars select dropDown index=0

selectAndWait currencySelector value=AUD

selectAndWait currencySelector label=Auslian D*rs

goBack,close goBack()

模拟点击浏览器的后退按钮 close()

模拟点击浏览器关闭按钮

selectWindow select(windowId) - 选择一个弹出窗口

- 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行 selectWindow myPopupWindow selectWindow null

pause

pause(millisenconds)

- 根据指定时间暂停Selenium脚本执行

- 常用在调试脚本或等待服务器段响应时 pause 5000 pause 2000

fireEvent

fireEvent(elementLocatore,evenName)

模拟页面元素事件被激活的处理动作 fireEvent textField focus fireEvent dropDown blur

waitForCondition

waitForCondition(JavaScriptSnippet,time)

- 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待 waitForCondition var value=selenium.getText(\"foo\"; value.match(/bar/); 3000

waitForValue

waitForValue(inputLocator, value)

- 等待某input(如hidden input)被赋予某值， - 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞 waitForValue finishIndication isfinished

store,stroreValue

store(valueToStore, variablename) 保存一个值到变量里。

该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量 store Mr John Smith fullname

store $.｛title｝ $.｛firstname｝ $.｛suname｝ fullname store javascript.｛Math.round(Math.PI*100)/100｝ PI storeValue inputLocator variableName

把指定的input中的值保存到变量中

storeValue userName userID type userName $.｛userID｝

storeText, storeAttribute

storeText(elementLocator, variablename)

把指定元素的文本值赋予给变量 storeText currentDate expectedStartDate verifyValue startDate $.｛expectedStartDate｝

storeAttribute(.｛｝elementLocator@attributeName,variableName.｛｝) 把指定元素的属性的值赋予给变量

storeAttribute input1@class classOfInput1

verifyAttribute input2@class $.｛classOfInput1｝

chooseCancel.., answer..

chooseCancelOnNextConfirmation()

- 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel

- 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样 chooseCancelOnNextConfirmation

- 如果已经运行过该命令，当下一次又有confirm对话框出现时，也会同样地再次选择Cancel

answerOnNextPrompt(answerString)

- 在下次JavaScript弹出prompt提示框时，赋予其anweerString的值，并选择确定

answerOnNextPrompt Kangaroo

三、 Assertions

允许用户去检查当前状态。两种模式: Assert 和 Verify， 当Assert失败，则退出测试；当Verify失败，测试会继续运行。

assertLocation, assertTitle

assertLocation(relativeLocation)

判断当前是在正确的页面 verifyLocation /mypage assertLocation /mypage

assertTitle(titlePattern)

检查当前页面的title是否正确 verifyTitle My Page assertTitle My Page

assertValue

assertValue(inputLocator, valuePattern) - 检查input的值

- 对于 checkbox或radio，如果已选择，则值为\"on\反之为\"off\" verifyValue nameField John Smith

assertValue document.forms[2].nameField John Smith

assertSelected, assertSelectedOptions

assertSelected(selectLocator, optionSpecifier)

检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同 verifySelected dropdown2 John Smith verifySelected dorpdown2 value=js*123

assertSelected document.forms[2].dropDown label=J*Smith assertSelected document.forms[2].dropDown index=0

assertSelectOptions(selectLocator, optionLabelList) - 检查下拉菜单中的选项的文本是否和optionLabelList相同

- optionLabelList是以逗号分割的一个字符串 verifySelectOptions dropdown2 John Smith,Dave Bird

assertSelectOptions document.forms[2].dropdown Smith,J,Bird,D

assertText

assertText(elementLocator,textPattern) - 检查指定元素的文本

- 只对有包含文本的元素生效

- 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本 verifyText statusMessage Successful assertText //div[@id='foo']//h1 Successful

assertTextPresent, assertAttribute assertTextPresent(text)

检查在当前给用户显示的页面上是否有出现指定的文本 verifyTextPresent You are now logged in

assertTextPresent You are now logged in

assertAttribute(.｛｝elementLocator@attributeName.｛｝, ValuePattern) 检查当前指定元素的属性的值 verifyAttribute txt1@class bigAndBlod assertAttribute document.images[0]@alt alt-text verifyAttribute //img[@id='foo']/alt alt-text

assertTextPresent, etc. assertTextPresent(text) assertTextNotPresent(text)

assertElementPresent(elementLocator) verifyElementPresent submitButton

assertElementPresent //img[@alt='foo'] assertElementNotPresent(elementLocator)

assertTable

assertTable(cellAddress, valuePattern)

- 检查table里的某个cell中的值

- cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始 verifyTable myTable.1.6 Submitted assertTable results0.2 13

assertVisible, nonVisible assertVisible(elementLocator) - 检查指定的元素是否可视的

- 隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none' verfyVisible postcode assertVisible postcode

assertNotVisible(elementLocator) verfyNotVisible postcode assertNotVisible postcode

Editable, non-editable

assertEditable(inputLocator)

检查指定的input是否可以编辑 verifyEditable shape assertEditable colour

assertNotEditable(inputLocator) 检查指定的input是否不可以编辑 assertAlert

assertAlert(messagePattern)

- 检查JavaScript是否有产生带指定message的alert对话框 - alert产生的顺序必须与检查的顺序一致

- 检查alert时会产生与手动点击'OK'按钮一样的效果。如果一个alert产生了，而你却没有去检查它，selenium会在下个action中报错。

- 注意：Selenium 不支持 JavaScript 在onload()事件时 调用alert();在这种情况下，Selenium需要你自己手动来点击OK. assertConfirmation

assertConfirmation(messagePattern)

- 检查JavaScript是否有产生带指定message的confirmation对话框和alert情况一样，confirmation对话框也必须在它们产生的时候进行检查

- 默认情况下，Selenium会让confirm() 返回true, 相当于手动点击Ok按钮的效果。你能够通过chooseCancelOnNextConfirmation命令让confirm()返回false.同样地，如果一个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错 - 注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框 - 注意：Selenium不支持在onload()事件时调用confirmation对话框，在这种情况下，会出现显示confirmatioin对话框，并需要你自己手动点击。 assertPrompt

assertPrompt(messagePattern)

- 检查JavaScript是否有产生带指定message的Prompt对话框 - 你检查的prompt的顺序Prompt对话框产生的顺序必须相同

- 必须在verifyPrompt之前调用answerOnNextPrompt命令

- 如果prompt对话框出现了但你却没有检查，则Selenium会在下个action中报错 answerOnNextPrompt Joe click id=delegate

verifyPrompt Delegate to who?

四、 Parameters and Variables

参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。 Store，storeValue 和storeText 为下次访问保存值。

在Selenium内部是用一个叫storeVars的map来保存变量名。

Variable Substitution 变量替换

提供了一个简单的方法去访问变量,语法 $.｛xxx｝ store Mr title storeValue nameField surname

store $.｛title｝ $.｛suname｝ fullname

type textElement Full name is: $.｛fullname｝

JavaScript Evaluation JavaScript赋值

你能用JavaScript来构建任何你所需要的值。

这个参数是以javascript开头，语法是 javascript.｛'with a trailing'｝。

可以通过JavaScript表达式给某元素赋值。 store javascript.｛'merchant'+(new Date()).getTime()｝ merchantId

type textElement javascript.｛storedVars['merchantId'].toUpperCase()｝

Generating Unique values 产生唯一值. 问题：你需要唯一的用户名

解决办法: 基于时间来产生用户名，如'fred'+(new Date().getTime()) 17:03 | 添加评论 | 固定链接 | 写入日志 Selenium中文手册 Selenium中文手册 Selenium中文手册

一、 Commands (命令)

Action

对当前状态进行操作 失败时，停止测试 Assertion

校验是否有产生正确的值 Element Locators

指定HTML中的某元素 Patterns

用于模式匹配

1. Element Locators (元素定位器)

id=id

id locator 指定HTML中的唯一id的元素 name=name

name locator指定 HTML中相同name的元素中的第一个元素 identifier=id

identifier locator 首先查找HTML是否存在该id的元素, 若不存在，查找第一个该name的元素

dom=javascriptExpression

dom locator用JavaScript表达式来定位HTML中的元素,注意必须要以\"document\"开头 例如:

dom=document.forms['myForm'].myDropdown dom=document.images[56] xpath=xpathExpression

xpath locator用 XPath 表达式来定位HTML中的元素,必须注意要以\"//\"开头 例如：

xpath=//img[@alt='The image alt text'] xpath=//table[@id='table1']//tr[4]/td[2] link=textPattern

link locator 用link来选择HTML中的连接或锚元素 例如:

link=The link text

在没有locator前序的情况下 Without a locator prefix, Selenium uses: 如果以\"document.\"开头，则默认是使用 dom locator，如果是以\"//\"开头，则默认使用xpath locator,其余情况均认作identifier locator 2. String Matching Patterns (字符串匹配模式)

glob:patthern

glob模式，用通配符\"*\"代表任意长度字符，\"?\"代表一个字符 regexp:regexp

正则表达式模式，用JavaScript正则表达式的形式匹配字符串 exact:string

精确匹配模式，精确匹配整个字符串，不能用通配符

在没有指定字符串匹配前序的时候，selenium 默认使用golb 匹配模式 3. Select Option Specifiers (Select选项指定器)

label=labelPattern

通过匹配选项中的文本指定选项 例如：label=regexp:^[Oo]ther value=valuePattern

通过匹配选项中的值指定选项 例如：value=other id=id

通过匹配选项的id指定选项 例如: id=option1 index=index

通过匹配选项的序号指定选项，序号从0开始 例如：index=2

在没有选项选择前序的情况下，默认是匹配选项的文本 二、 Actions

描述了用户所会作出的操作。

Action 有两种形式: action和actionAndWait, action会立即执行，而actionAndWait会假设需要较长时间才能得到该action的相响，而作出等待，open则是会自动处理等待时间。

click

click(elementLocator)

- 点击连接,按钮，复选和单选框

- 如果点击后需要等待响应，则用\"clickAndWait\"

- 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作，则需要调用

verify或assert来告诉Selenium你期望对对话框进行什么操作。 click aCheckbox clickAndWait submitButton clickAndWait anyLink open

open(url)

- 在浏览器中打开URL,可以接受相对和绝对路径两种形式

- 注意：该URL必须在与浏览器相同的安全限定范围之内 open /mypage open http://localhost/ type

type(inputLocator, value)

- 模拟人手的输入过程，往指定的input中输入值 - 也适合给复选和单选框赋值

- 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本 type nameField John Smith

typeAndWait textBoxThatSubmitsOnChange newValue 17:02 | 添加评论 | 固定链接 | 写入日志 Selenium备用手册

1. Executing Javascript from Your Test

public static String[] getAllCheckboxIds () {

String script = \"var inputId = new Array();\";// Create array in java script.

script += \"var cnt = 0;\"; // Counter for check box ids. script += \"var inputFields = new Array();\"; // Create array in java script.

script += \"inputFields =

window.document.getElementsByTagName('input');\"; // Collect input elements.

script += \"for(var i=0; iscript += \"if(inputFields[i].id !=null \" + \"&& inputFields[i].id !='undefined' \" + \"&& inputFields[i].getAttribute('type') == 'checkbox') {\"; // If input field is of type check box and input id is not null. script += \"inputId[cnt]=inputFields[i].id ;\" + // Save check box id to inputId array.

\"cnt++;\" + // increment the counter. \+ // end of if. \; // end of for.

script += \"inputId.toString();\" ;// Convert array in to string.

String[] checkboxIds =

selenium.getEval(script).split(\); // Split the string. return checkboxIds; }

2. Waiting for an AJAX Element

In AJAX-driven web applications, using Selenium’s waitForPageToLoad wouldn’t work as the page is not actually loaded to refresh the AJAX element.

// Loop initialization.

for (int second = 0;; second++) {

// If loop is reached 60 seconds then break the loop. if (second >= 60) break;

// Search for element \"link=ajaxLink\" and if available then break loop.

try { if (selenium.isElementPresent(\"link=ajaxLink\")) break; } catch (Exception e) {}

// Pause for 1 second. Thread.sleep(1000);

3. RegularExpression E[foo=\"bar\"] an E element whose \"foo\" attribute #attribute-selectors value is exactly equal to \"bar\" an E element whose \"foo\" attribute value is a list of space-separated E[foo~=\"bar\"] values, one of which is exactly equal to \"bar\" an E element whose \"foo\" attribute E[foo^=\"bar\"] value begins exactly with the string #attribute-selectors \"bar\" an E element whose \"foo\" attribute E[foo$=\"bar\"] value ends exactly with the string #attribute-selectors \"bar\" an E element whose \"foo\" attribute E[foo*=\"bar\"] #attribute-selectors value contains the substring \"bar\" e.g. IsElementPresent(\"css=input[id*='UserName']\") (css= is the prefered way to finding elements)

4. pop-up window can not be captured by selenium, if it is triggered by submit button

if the form attribute \"target\" is _blank, and the submission is caused by submit button, not the submit method, the pop-up window can not be captured, for example: source code: id=\"bottomForm\"

method=\"get\"

target=\"_blank\"

name=\"searchForm\"

action=\"http://video.google.com/\">

test script:

selenium.click(\"buttonSearch\");

String[] names = selenium.getAllWindowNames(); // i only get one window name, \"main\" resolution:

modify BrowserBot.prototype._modifyElementTarget() methond in selenium-browserbot.js, let it detect submit button.

BrowserBot.prototype._modifyElementTarget = function(element) {

/**

 if the element is submit button, change the element to it's form parent */

if(getTagName(element) == 'input' && element.type == 'submit') element = element.form;

if (element.target) {

if (element.target == \"_blank\" || /^selenium_blank/.test(element.target) ) { var tagName = getTagName(element);

if (tagName == \"a\" || tagName == \"form\") { var newTarget = \"selenium_blank\" + Math.round(100000 * Math.random()); LOG.warn(\"Link has target '_blank', which is not supported in Selenium! Randomizing target to be: \" + newTarget); this.browserbot.openWindow('', newTarget); element.target = newTarget; } } } }