Selenium_中文API

支付宝（中国）网络科技有限公司

Selenium常用方法介绍星火燎原项目组

版本：0.2

日期：2010.05

编写：李红梅

文档修订控制

目录

1概述 (5)

2Selenium常用方法 (5)

2.1Selenium系统级方法 (5)

2.1.1void start( ) (5)

2.1.2 void stop() (7)

2.1.3 void shutDownSeleniumServer() (7)

2.2Selenium模拟操作浏览器（Actions） (8)

2.2.1void open(String url) (8)

2.2.2void openWindow(String url,String windowID) (9)

2.2.3void close() (9)

2.2.4void type(String locator,String value) (9)

2.2.5void submit(String formLocator) (10)

2.2.6void click(String locator) (10)

2.2.7void doubleClick(String locator) (10)

2.2.8void clickAt (String locator,String coordString) (11)

2.2.9void focus(String locator) (11)

2.2.10void check(String locator) (11)

2.2.11void uncheck(String locator) (12)

2.2.12void keyPress(String locator,String keySequence) (12)

2.2.13void shiftKeyDown() (13)

2.2.14void shiftKeyUp() (13)

2.2.15void altKeyDown() (13)

2.2.16void altKeyUp () (13)

2.2.17void controlKeyDown () (14)

2.2.18void controlKeyUp () (14)

2.2.19void keyDown (String locator,String keySequence) (14)

2.2.20void keyUp (String locator,String keySequence) (15)

2.2.21void setSpeed(String value) (15)

2.2.22void getSpeed() (15)

2.2.23select(String selectLocator,String optionLocator); (16)

2.2.24void selectWindow(String windowID); (16)

2.2.25void selectPopUp(String windowID) (18)

2.2.26void deselectPopUp() (19)

2.2.27void selectFrame(String locator) (19)

2.2.28void waitForPopUp(String windowID,String timeout) (19)

2.2.29void chooseCancelOnNextConfirmation() (20)

2.2.30void chooseOkOnNextConfirmation() (20)

2.2.31void answerOnNextPrompt(String answer) (21)

2.2.32void windowFocus() (21)

2.2.33void windowMaximize() (21)

2.3.34void waitForCondition(String script,String timeout) (22)

2.3.35void setTimeout(String timeout) (22)

2.3.36waitForPageToLoad(String timeout) (22)

2.3.37 waitForFrameToLoad(frameAddress, timeout) (23)

2.3.38void runScript(String script) (23)

2.3.39void attachFile(String fieldLocator,String fileLocator) (24)

2.3.40void captureScreenshot(String filename) (24)

2.3.41String captureScreenshotToString() (25)

2.3Selenium判断预期需要（Assertions） (25)

2.3.1boolean isAlertPresent() (25)

2.3.2boolean isPromptPresent() (25)

2.3.3boolean isConfirmationPresent() (26)

2.3.4String getAlert() (26)

2.3.5String getConfirmation() (27)

2.3.6String getPrompt() (27)

2.3.7boolean isChecked(String locator) (28)

2.3.8boolean isTextPresent(String pattern) (28)

2.3.9boolean isElementPresent(String locator) (28)

2.3.10boolean isVisible(String locator) (29)

2.3.11boolean isEditable(String locator) (29)

2.4Selenium常用取值方法 (30)

2.4.1String getLocation() (30)

2.4.2String getTitle() (30)

2.4.3String getBodyText() (30)

2.4.4String getV alue(String locator) (31)

2.4.5String getText(String locator) (31)

2.4.6String getEval(String script) (31)

2.4.7String getTable(String tableCellAddress) (32)

2.4.8String[] getSelectedV alues(String selectLocator) (32)

2.4.9String getSelectedV alue(String selectLocator) (33)

2.4.10String getAttribute(String attributeLocator) (33)

2.4.11String[] getAllButtons() (33)

2.4.12String[] getAllLinks() (34)

2.4.13String[] getAllFields() (34)

2.4.14String[] getAllWindowIds() (34)

2.4.15String[] getAllWindowNames() (34)

2.4.16String[] getAllWindowTitles() (35)

2.4.17String getHtmlSource() (35)

3Xpath相关语法 (35)

1概述

HELLO ，大家好，欢迎打开本文。

该文档是为初次接触Selenium的同学而编，初衷是让同学们能够快速了解该框架提供的常用方法，方便在遇到合适的场景中使用，由于编者是初学者，技术能力拙劣，英文水平有限，可能存在部分方法的说明或示例存在不到位甚至是错误，欢迎同学们指正完善。

Selenium是ThoughtWorks 专门为Web 应用而开发的自动化测试工具，适合进行功能测试，可直接运行在浏览器之上，使得测试脚本可以在受支持的浏览器中运行，但是Selenium是轻量的测试框架，脚本所处理的测试用例构成简单，其实质就是通过HTTP 协议，发送请求(request)来完成测试用例，所以很困难处理业务逻辑关系强的测试用例。

关于Selenium产生背景以及原理，可参考新手入门教程，该文档是网上找到的相对比较全面的文档，基本能满足初学者的需要,见下文第三章中的“新手入门教程”。

接下来将着重介绍Selenium框架的常用方法，包含Selenium系统级方法、模拟浏览器操作的方法以及判断预期结果和常用的取值方法，也顺便把Xpath相关语法整合在一起,具体详见下文：

2Selenium常用方法

2.1Selenium系统级方法

该部分主要是Selenium自带的方法，比如启动、停止Selenium进程或彻底结束一个Selenium服务代理。

2.1.1void start( )

2.1.2 void stop()

2.1.3 void shutDownSeleniumServer()

2.2 Selenium模拟操作浏览器（Actions）

此类方法描述了用户所会作出的操作，模拟用户与Web 应用程序的交互。例如，单击一个按钮和填写一个表单，这些都是常见的用户操作，可以用Selenium 命令来自动化这些操作。有的Action是立即执行并返回结果，如type、select等，但有的则需要等待一段时间才能返回结果，如open、click等，这就需要用到waitfor***这类方法。

2.2.1void open(String url)

2.2.2void openWindow(String url,String windowID)

2.2.3void close()

2.2.4void type(String locator,String value)

2.2.5void submit(String formLocator)

2.2.6void click(String locator)

2.2.7void doubleClick(String locator)

2.2.8void clickAt (String locator,String coordString)

2.2.9void focus(String locator)

2.2.10void check(String locator)

2.2.11void uncheck(String locator)

2.2.12void keyPress(String locator,String keySequence)

2.2.13void shiftKeyDown()

2.2.14void shiftKeyUp()

2.2.15void altKeyDown()

2.2.16void altKeyUp ()

2.2.17void controlKeyDown ()

2.2.18void controlKeyUp ()

2.2.19void keyDown (String locator,String keySequence)

2.2.20void keyUp (String locator,String keySequence)

2.2.21void setSpeed(String value)

2.2.22void getSpeed()

2.2.23select(String selectLocator,String optionLocator);

2.2.24void selectWindow(String windowID);

2.2.25void selectPopUp(String windowID)

2.2.26void deselectPopUp()

2.2.27void selectFrame(String locator)

2.2.28void waitForPopUp(String windowID,String timeout)

2.2.29void chooseCancelOnNextConfirmation()

2.2.30

void chooseOkOnNextConfirmation()