RFS类库关键字使用说明

Alert Should Be Present

Arguments:[ text= ]

Verifies an alert is present and dismisses it.

If `text` is a non-empty string, then it is also verified that the message of the alert equals to `text`.

Will fail if no alert is present. Note that following keywords will fail unless the alert is dismissed by this keyword or another like `Get Alert Message`.

说明:校验是否有 alert 提示框出现。如果提示框信息不为空,则它将校验 alert 信息是否与 text 一致。

例子:Alert Should Be Present | 保存成功

Assign Id To Element

Arguments:[ locator | id ]

Assigns a temporary identifier to element specified by `locator`.

This is mainly useful if the locator is complicated/slow XPath expression. Identifier expires when the page is reloaded.

说明:分配一个临时ID给特殊元素(缺少ID或name)。

例子:Assign Id To Element |//div[@class='textarea-clear-btn'] |ClassID01

Capture Page Screenshot

Arguments:[ filename=None ]

说明:截取当前页面并将其嵌入到日志。Filename 参数指定写入日志的截图名称。如果该参数为空,那么截图名称将以”selenium-screenshot-.png”格式保存到 RF志文件所在目录下。

例子:Capture Page Screenshot |截图20160925001

Checkbox Should Be Selected

Arguments:[ locator ]

说明:验证复选框已被选中/勾选。

例子:Checkbox Should Be Selected |CheckBoxIDorName

Checkbox Should Not Be Selected

Arguments:[ locator ]

说明:验证复选框未被选中/勾选。

例子:Checkbox Should Not Be Selected |CheckBoxIDorName

Choose Cancel On Next Confirmation

Arguments:[ ]

Cancel will be selected the next time `Confirm Action` is used.

说明:在含“确定/取消”的弹出框中选择“取消”,需要与关键字(Confirm Action)组合使用。

例子:

Choose Cancel On Next Confirmation

Confirm Action    #选择“取消”

Choose File

说明:选择文件。在上传页面,直接使用该关键字。或与关键字(get file)组合使用。

例子:

choose file | xpath=//div[@class='pd6 dot fcb']/span/input | C:\\Documents and Settings\\xxx\\My Documents\\My Pictures\\bug5.png

choose file | get file | C:\\Documents and Settings\\xxx\\My Documents\\My Pictures\\bug5.png

Choose Ok On Next Confirmation

说明:在含“确定/取消”的弹出框中选择“确定”。

例子:Choose Ok On Next Confirmation

Click Element

说明:点击元素。可运用在任何需要点击的元素上:按钮、图片、文字、超链接等。

例子:Click Element | xpath=//input[@value='百度一下']    #点击【百度一下】按钮

Click Element At Coordinates

说明:通过 x,y 坐标点击页面元素。

例子:暂未使用过,待补充......

Click Image

说明:点击被定位的图片。

例子:

Click Image | imgLogo

Click Image | xpath=//img[src='https://xx.xxx.xxxx.com/t0151320b1d0fc50be8.png']

Click Link

说明:点击被定位的链接。

例子:Click Link | LinkID

Close Window

说明:关闭当前打开(置顶)的弹出框。

Confirm Action

说明:当前显示 confirm 对话框并返回它的 message 信息。默认情况下,该关键字选择对话框中的“确定”项。如果需要选择“取消”项,请在该关键字执行前调用“Choose Cancel On Next Confirmation”,以免对话框已关闭。

例子1:

Confirm Action    #单独使用时,默认点击【确定】

例子2:

Choose Cancel On Next Confirmation

Confirm Action    #配合关键字Choose Cancel On Next Confirmation使用,则点击【取消】

Current Frame Contains

说明:验证当前frame包含的文本内容。可以查看“Page Should Contain”关于loglevel 参数的解释。

Current Frame Should Not Contain

说明:验证当前frame不应包含的文本。可以查看“Page Should Contain”关于loglevel 参数的解释。

Delete All Cookies

说明:删除所有Cookies。

例子:暂未使用过,待补充.....

Delete Cookie

Arguments:[ name ]

Deletes cookie matching `name`.

If the cookie is not found, nothing happens.

说明:删除与参数 name 匹配的 cookies 信息。当未匹配到对应 name 的 cookies 信息,则不执行。

例子:暂未使用过,待补充......

Double Click Element

说明:双击元素。

例子:Double Click Element | ElementID

Element Should Be Disabled

Arguments:[ locator ]

说明:验证元素应被禁用(不可用)。

例子:Element Should Be Disabled | ElementID

Element Should Be Enabled

说明:验证元素应可用。

例子:Element Should Be Enabled | ElementID

Element Should Be Visible

说明:验证元素应可见(页面有显示)。

例子:Element Should Be Visible | ElementID | 返回自定义错误消息:对不起,该元素不可见。

Element Should Contain

说明:验证元素应包含的文本。

例子:Element Should Contain | ElementID | 期望的文本内容 | 返回自定义错误消息:对不起,该元素不包含XXX文本。

Element Should Not Be Visible

说明:验证元素应是不可见的。

例子:Element Should Not Be Visible | ElementID | 返回自定义错误消息:对不起,该元素却可见。

Element Text Should Be

说明:验证元素应完全包含的文本。

例子:Element Text Should Be | ElementID | 期望的文本内容 | 返回自定义错误消息:对不起,该元素不完全包含XXX文本。

Execute Javascript

说明:执行JavaScript脚本。

例子:Execute JavaScript | window.my_js_function('arg1', 'arg2')

Focus

说明:聚焦元素。如某元素在页面上因拖动滚动条才能显示的,对该元素操作前,可使用Focus将焦点定位到该元素上,避免元素操作时找不到该元素。

例子:Focus | ElementID

Frame Should Contain

说明:验证Frame(框架)应该包含的文本。

例子:Frame Should Contain | ElementID| 期望的文本

Get Alert Message

说明:返回警报弹出消息的文本内容,将文本返回给参数。

例子:${ReturnMessage} | Get Alert Message

Get All Links

说明:返回当前页包含的所有链接,将链接以列表的形式返回给参数。

例子:${ReturnLinks} | Get All Links

Get Cookie Value

说明:返回cookie的值,将值返回给参数。

例子:${ReturnValue} | Get Cookie Value | CookieName

Get Cookies

说明:返回当前页面的所有Cookies,将Cookies返回给参数。

例子:${ReturnCookies} | Get Cookies

Get Element Attribute

Arguments:[ attribute_locator ]

说明:返回元素的指定属性内容,将属性内容返回给参数。

例子:${ReturnValue} | Get Element Attribute | element_id@class

你可能感兴趣的:(RFS类库关键字使用说明)