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

select
select(dropDownLoc