selenium API 手册Word文件下载.docx
《selenium API 手册Word文件下载.docx》由会员分享，可在线阅读，更多相关《selenium API 手册Word文件下载.docx（66页珍藏版）》请在冰豆网上搜索。
”
”
”
许多动作可以被包含后缀并等待的方式进行调用，例如点击并等待。
这个后
缀告知Selenium，该命令将使浏览器向服务器产生一个请求，并使得Selenium
等待加载一个新的页面。
（Accessors）
辅助（（AAcccceessssoorrss））用于检查应用程序的状态并将结果存储在变量中。
例
如”storeTitle”。
它们同样可用于自动生成断言。
（Assertions）
断言（（AAsssseerrttiioonnss））类似于辅助，但它们可以验证应用程序的状态是否同所期望的
X””
”
相一致。
例如包括确认页面标题为和验证该复选框是否被勾选。
所有的Selenium断言可以被用于三种模式：
”assert”,“verify”，和”waitfor”。
例如，
”assertText””verifyText”
”waitforText”
”assert”
你可以
，
，及
。
当
失败时，该测试将
终止。
当”verify”失败时，该测试将继续执行，并将错误记入日志。
这就允许了
通过单条”assert”确保应用程序在正确的页面上，而通过一系列的”verify”断言测
试表单上的区域值，标签等。
“waitfor”命令用于等待某些条件变为真可用于（
Ajax应用程序的测试。
如果该条）
件已经为真，他们将立即成功执行。
反之，如果该条件不为真，则将失败并暂停
测试，直到超过当前所设定的超时时间（参照后面的setTimeout动作）。
（ElementLocators）
元素定位器（（EElleemmeennttLLooccaattoorrss））告诉Selenium是向HTML中的哪一个元素发送命
令。
许多命令需要一个如”target”属性的元素定位器。
这其中包括”elementId”
和”document.forms[0].element”。
在接下来的部分将更详细的描述它们。
-----------------------Page2-----------------------
（Patterns）
式样（（PPaatttteerrnnss））由于多种因素被使用着，如指定一个输入域的期望值，或识别一
个选择选项。
Selenium支持许多类型的式样，其中包括正则表达式，所有这些将
在接下来的章节中进行更详细的描述。
定义一个类用于运行Selenium命令。
元素定位器（（EElleemmeennttLLooccaattoorrss））
元素定位器（ElementLocators）告诉Selenium是向HTML中的哪一个元素发送命
一个定位器的格式如下：
locatorType=argument
我们支持如下写法用于定位元素：
·
identifier=id:
根据指定的@id属性选择元素。
如果没有匹配的值，则选择
第一个@name属性为id的元素。
（参照后面）
id=id:
name=name:
选择第一个根据指定的@name所查找到的元素。
〇username
〇name=username
这里的name可以作为可选项跟在一个或多个元素过滤器的后面，通过空格进行
分隔。
如果没有指定过滤类型，则假定为value。
〇name=flavourvalue=chocolate
dom=javascriptExpression:
通过检测指定字符串查找元素。
这使得你可以通
过JavaScript贯穿HTML文档对象。
注意在这个字符串中返回值不是必须的；
仅仅只需要确保这条语句是你块中的最后一条。
〇dom=document.forms[?
myForm?
].myDropdown
〇dom=document.images[56]
〇dom=functionfoo（）{returndocument.links[1];
};
foo（）;
xpath=xpathExpression:
通过XPath表达式定位元素。
〇xpath=//img[@alt=?
Theimagealttext?
]
〇xpath=//table[@id=table1]//tr[4]/td[2]?
?
〇xpath=//a[contains（@href,#id1）]?
〇xpath=//a[contains（@href,?
#id1?
）]/@class
〇xpath=（//table[@class=?
stylee?
]）//th[text（）=?
theHeaderText?
]/../
td
?
〇xpath=//input[@name=name2and@value=yes]
〇xpath=//*[text（）=″right″]
link=textPattern:
选择所包含的文字匹配指定式样的链接（锚）。
〇link=Thelinktext
css=cssSelectorSyntax:
通过css选择器选择元素。
请查询CSS2选择器，
CSS3选择器以获得更多信息。
在下载下来的seleniumcorepackage中的
seleniumtestsuite里的TestCssLocatorstest,你同样可以查看到使用例
子。
〇css=a[href=″#id3″]
-----------------------Page3-----------------------
〇css=span#firstChid+span
当前css选择过滤器支持所有的css1,css2,css3,除了css3中一些虚拟类
（:
nth-of-type,:
nth-last-of-type,:
first-of-type,:
last-of-type,:
only-of
-type,:
visited,:
hover,:
active,:
focus,:
indeterminate）以及虚拟元素
:
first-line,:
first-letter,:
selection,:
before,:
after）。
如果没有一个显式的前缀，Selenium使用以下默认写法：
dom,用于开头为″document.″的定位器
xpath,用于开头为″//″的定位器
identifier，其他
元素过滤器（ElementFilters）
元素过滤器可以同选择器一起使用，从一堆候选元素中进行筛选。
它们当前仅使
用于’name’元素选择器。
过滤器看起来更像是选择器，也就是：
filterType=argument
所支持的元素过滤器为：
value
vvaalluuee=valuePattern
匹配元素时基于它们的值进行匹配。
这在对一堆相似命名的关联按钮的筛
选中显得尤其有用。
index
iinnddeexx=index
（
0
）
选择单个元素基于其在列表中的位置从开始。
字符串匹配式样
有各种各样的式样语法可用于匹配字符串值：
glob:
pattern:
用″glob″去匹配一个字符串。
″Glob″是一种用于命令行shells
glob
″*″
的代表性的有限正则表达式语法。
在一个
式样中
代表任意序列字符集，
而″?
″则代表任意单个字符。
Glob式样匹配整个字符串。
regexp:
使用正则表达式匹配字符串。
可使用所有的JavaScript正则
表达式。
如果没有指定式样前缀，Selenium假定其为″glob″式样。
SeleniumActions
addLocationStrategy（strategyName,functionDefinition）
aaddddLLooccaattiioonnSSttrraatteeggyy（（ssttrraatteeggyyNNaammee,,ffuunnccttiioonnDDeeffiinniittiioonn））
为selenium定义一个新的函数用于定位页面上的元素。
例如，如果你定义了
一个方法″foo″,并运行了click（″foo=blah″），我们将运行你的函数，传递给你字
-----------------------Page4-----------------------
符串″blah″，并点击该函数所返回的元素，如果返回为null，则抛出一个″Element
notfound″的错误。
我们将给该函数传递三个参数。
locator:
用户传递过来的字符串
inWindow:
当前所选中的窗体
inDocument:
当前所选中的文档
如果未找到相应的元素，则函数必须返回一个null。
参数：
strategyName–定义的方法名；
只能使用字母[a-zA-Z],不能包含空格
升级会员 