[计算机硬件及网络]selenium中文api参考手册

[计算机硬件及网络]selenium中文api参考手册内容摘要：

是该键的 ASCII值 )，或是个单字符，如 ―w―,―\119―。 metaKeyDown() metaKeyDown() mmeettaaKKeeyyDDoowwnn(()) 按下 meta 键并保持其按下状态，直到 doMetaUp()被调用或一个新的页面被加 载。 metaKeyUp() metaKeyUp() mmeettaaKKeeyyUUpp(()) 释放 meta 键 mouseDown(locator) mouseDown(locator) mmoouusseeDDoowwnn((llooccaattoorr)) 模拟用户在指定元素上按下鼠标按钮除了还没释放的。 ( ) 参数： locator一个元素定位器 mouseDownAt(locator,coordString) mouseDownAt(locator,coordString) mmoouusseeDDoowwnnAAtt((llooccaattoorr,ccoooorrddSSttrriinngg)) 模拟用户在指定位置上按下鼠标按钮除了还没释放的。 ( ) 参数： locator一个元素定位器 coordString指定由定位器返回的鼠标事件相关联的元素 x,y 坐标 (也就 是 –10,20) mouseMove(locator) mouseMove(locator) mmoouusseeMMoovvee((llooccaattoorr)) 模拟用户在指定元素上按下鼠标按钮除了还没释放的。 ( ) 参数： locator一个元素定位器 mouseMoveAt(locator,coordString) mouseMoveAt(locator,coordString) mmoouusseeMMoovveeAAtt((llooccaattoorr,ccoooorrddSSttrriinngg)) 模拟用户在指定位置上按下鼠标按钮除了还没释放的。 ( ) 参数： locator一个元素定位器 coordString指定由定位器返回的鼠标事件相关联的元素 x,y 坐标 (也就 是 –10,20) Page 9 mouseOut(locator) mouseOut(locator) mmoouusseeOOuutt((llooccaattoorr)) 模拟用户从指定元素上移开鼠标指针。 参数： locator一个元素定位器 mouseOver(locator) mouseOver(locator) mmoouusseeOOvveerr((llooccaattoorr)) 模拟用户鼠标滑过指定元素。 参数： locator一个元素定位器 mouseUp(locator) mouseUp(locator) mmoouusseeUUpp((llooccaattoorr)) 模拟用户在指定元素上释放鼠标按钮时发生的事件 (也就是，停止保持按钮按 下 )。 参数： locator一个元素定位器 mouseUpAt(locator,coordString) mouseUpAt(locator,coordString) mmoouusseeUUppAAtt((llooccaattoorr,ccoooorrddSSttrriinngg)) 模拟用户在指定元素上释放鼠标按钮时发生的事件也就是，停止保持按钮按 ( 下。 ) 参数： locator一个元素定位器 coordString指定由定位器返回的鼠标事件相关联的元素 x,y 坐标 (也就 是 –10,20) open(url) open(url) ooppeenn((uurrll)) URL URLs ‖open‖ 在测试框架中打开一个 ，可以为相对和绝对。 命令将等待页 ‖ ‖ 面加载完成才继续进行，也就是明确的指名并等待后缀。 注意：由于浏览器 安全策略 (相同来源方针 )这个 URL 必须和当前运行的 HTML 在相同的域。 如 果你不得不在另一个域打开一个 URL，则需要用 Selenium服务在另一个域去 打开一个新的浏览器会话。 参数： url–要打开的 URL,可以为空 windowID–要选择窗体的 JavaScriptwindowID pause(waitTime) 等待指定时间 (以毫秒为单位 ) 参数： waitTime–要睡眠的时间 (以毫秒为单位 ) refresh() 模拟用户点击浏览器上的 ‖Refresh‖按钮。 removeAllSelections(locator) removeAllSelections(locator) rreemmoovveeAAllllSSeelleeccttiioonnss((llooccaattoorr)) Page 10 取消所有可多选元素的选择状态。 参数： locator–一个用于识别多选框的元素定位器 removeSelection(locator,optionLocator) removeSelection(locator,optionLocator) rreemmoovveeSSeelleeccttiioonn((llooccaattoorr,ooppttiioonnLLooccaattoorr)) 从用选项定位器进行筛选的多选元素的筛选集合中移除一个集合。 @在 doSelect中查看选项定位器的详细信息。 参数： locator–一个用于识别多选框的元素定位器 optionLocator–一个选 项定位器 (默认为一个标签 ) runScript(script) runScript(script) rruunnSSccrriipptt((ssccrriipptt)) 在当前测试窗体的 body 中创建一个新的 ‖script‖标签，并在 body 中添加指定的 命令文本。 用这种方式执行脚本，通常可以比使用 Selenium的 ‖getEval‖方式更 简易的进行调试。 要注意的是，由这种脚本标签所抛出的异常不受 Selenium管 理，因此当该脚本有可能会抛出异常时，你需要用 try/catch 块将其包含起来。 script–需要执行的 JavaScript片段 select(selectLocator,optionLocator) select(selectLocator,optionLocator) sseelleecctt((sseelleeccttLLooccaattoorr,ooppttiioonnLLooccaattoorr)) 用选项选择器从一个下拉框中选择一个选项。 选项选择器提供不同的方法从一个 HTML 选择元素中识别选项。 (例如：选择 一个指定选项，或断言一个满足某种规范的选项 )有许多种形式的选择选项定位 器。 label=labelPattern:基于其标签匹配选项，如其有效文本。 (默认 ) 〇 label=regexp:^[Oo]ther value=valuePattern:基于其值匹配选项。 〇 value=other id=id:基于其 id 匹配选项。 〇 id=option1 index=index:基于其索引匹配选项 (从 0开始 )。 〇 index=2 如果没有为选项定位器提供前缀，则默认匹配为标签行为。 参数： selectLocator–一个用于识别下拉菜单的元素定位器 optionLocator–一个选项选择器默认为标签 ( ) selectFrame(locator) selectFrame(locator) sseelleeccttFFrraammee((llooccaattoorr)) 在当前窗体中选择一个框架你 可以多次调用这个命令用于选择嵌套框架。 要 ( ) 选择父框架，用 ‖relative=parent‖作为定位器；要选择顶级框架，用 ‖relative=top‖。 你同样可以通过基于 0的索引号选择框架；用 ‖index=0‖选择第一个框架，或者 用 ‖index=2‖选择第三个框架。 你同样可以直接使用一个 DOM 表达式来识别你要的框架。 像这样： dom=frames[―main‖].frames[―subframe‖] Page 11 参数： locator–一个用于识别框架或子框架的元素定位器 selectWindow(windowID) selectWindow(windowID) sseelleeccttWWiinnddooww((wwiinnddoowwIIDD)) 选择一个弹出窗体；一旦一个弹出窗体被选中，所有的命令将指向该窗体。 要 再次选择主窗体，将对象设定为 null。 window JavaScript ‖name‖ window ( 注意： 的内在 的 属性和被给与的 文档通常是 ) ‖title‖ 你实际看到的，作为最终用户，在窗体的标题栏上的 之间有一个很大的 不同。 ‖name‖对于最终用户通常是不可见的；它是作为第二个参 数 ‖windowName‖传递给 JavaScript函数 (url,windowName,windowFeatures,replaceFlag)( Selenium ) 被 截取。 Selenium有许多方法用于查找被 ‖windowID‖参数所提及的窗体对象。 1.) 如果 windowID 为 null， (或是字符串 ‖null‖)，则假定为用户是提交给由浏览 器最初实例化的窗体。 2.) 如果 ‖windowID‖参数的值是当前应用窗体的一个 JavaScript变量名，则假 定该变量包含一个由调用 ()函数所产生的返回值。 3.) 另外， seleniumlooksinahashitmaintainsthatmapsstringnamestowindow ―names‖. 4.) 如果失败了，我们将循环遍历所有已知的窗体以便试图找出适合的 ‖title‖。 由于 ‖title‖不是必须唯一，因此可能会产生一些非期望的行为。 如果很难判定你所要操作的窗体的名称，你可以查看为识别通过 ( Selenium ) selenium 被 截取所打开窗体的名 称时所产生的 日志消 息。 在每个。