WEB自动化快速编写工具

These details have not been verified by PyPI

Project links

Homepage

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Project description

框架介绍

fasttest-selenium 是由Python语言开发的WEB端自动化框架，通过yaml编写相应的action即可调用Selenium API完成自动化测试。
文档介绍

idea

能否同时运行多个不同的浏览器，解决兼容性测试问题
通过插件快速输入关键字

已完成功能

selenium 90%的Action支持
可拓展的公共方法和公共函数
高度还原steps的报告输出

待完成功能

数据类型优化：支持自定义复杂数据结构
结果报告优化：支持图片放大

快速体验

框架下载

fasttest-selenium已经发布到Python PyPi平台，可通过以下两种方式完成安装 1.在终端输入下方命令进行安装：

pip3 install fasttest-selenium

2.可前往代码仓库直接clone或下载源码。

下载源码后需要将包导入到当前项目中

项目依赖

该框架在Python3.7版本下开发，部分功能依赖第三方模块，故需要安装以下模块

PyYAML 用于解析yaml测试用例文件

pip3 install PyYAML

selenium WEB自动化框架

pip3 install selenium

colorama 日志高亮输出

pip3 install colorama

4.opencv-contrib-python 图片对比识别

pip3 install opencv-contrib-python==3.4.2.16

说明：opencv在3.4.2以上版本使用其算法需要授权确认，该版本最高支持Python3.7，如不需要图片对比能力，可安装最新版Python和opencv-contrib-python

测试Demo

Demo包含完整项目结构以及关键字测试用例，下载后可通过运行 runtest.py 启动测试执行

项目结构

项目树状图

├── Common           // 自定义关键字库  
|   ├── common.yaml  // 自定义关键字文件
├── Resource         // 文件资源目录
|   ├── test.png     // 图片资源
├── Report           // 结果报告目录  
├── Scripts          // 脚本函数目录 
|   ├── __init__.py  // 包标识文件
|   ├── test.py      // 脚本文件
├── TestCase         // 测试用例目录
|   ├── test.yaml    // 测试用例文件
├── config.yaml      // 项目配置文件  
├── data.json        // 数据配置文件  
├── runtest.py       // 项目执行文件

config 项目配置

config.yaml 包含了项目运行时必要参数，结构如下：
driver 固定参数，值为 selenium
browser 指定浏览器，包括 chrome 、 firefox 、 safari 、 ie 、 opera
isReset 每条用例执行完后是否重置浏览器，推荐设置为 True saveScreenshot 执行步骤是否保存截图，如果为True 将大大增加执行时间，推荐设置为 False ，只在执行异常时保存截图
implicitlyWait 隐式等待时间
maxWindow 窗口最大化
desiredcaps 启动参数配置，会根据 browser 拿到对应浏览器参数
driver 浏览器驱动，如驱动未添加环境变量中，可通过此参数指定驱动路径
options 浏览器启动参数，会自动添加到对应浏览器的options
testcast 用例执行路径，可指定某一条用例路径或者某一文件夹下面所有用例

driver: selenium
browser: chrome
isReset: True
saveScreenshot: False
implicitlyWait: 10
maxWindow: True
desiredcaps:
    - chrome:
        - driver: '/Users/xiongjunjie/Desktop/chromedriver'
          options: # 无头模式运行
            - '--headless'
            - '--dissble-gpu'
            - '--window-size=1920,1050'
      firefox:
        - driver: '/Users/xiongjunjie/Desktop/geckodriver'
          options:
            - '--headless'
            - '--dissble-gpu'
            - '--window-size=1920,1050'

testcase:
    - TestCase/common/
    - TestCase/selenium/cookies.yaml

data 数据配置

data.json 为数据配置，结构如下：
variable 全局变量配置，用例中可直接获取该配置下的数据
resource 资源路径配置，用例中可直接访问该相对路径下的文件资源
keywords 脚本函数配置，用例中可直接调用该配置下的函数

{
  "variable": {
    "userid": "admin",
    "password": 13456
  },
  "resource": {
    "baidu_logo": "Resource/baidu.png"
  },
  "keywords": [
    "keyDown",
    "getText"
  ]
}

例：直接调用 keywords 函数并传递userid的值和baidu_logo的路径

- keyDown(${userid},${baidu_logo})

runtest 执行入口

runtest.py 为整个项目执行入口，可直接执行该文件或在终端运行 python3 runtest.py 启动项目
start 方法有返回整体执行结果，方便接入持续集成或者生成自定义报告

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from fasttest_selenium import *

if __name__ == '__main__':

    project = Project()

    project.start()

Common 自定义关键字

Common 目录用于存放自定义的关键字，类似于PO模式中的Page，可以将用例中公共逻辑抽离出来保存到这里，它需要一个关键字来表达它的作用，所以我们需要为它指定一个唯一的名字，以便于我们在用例中可调用。
关键字结构：
common_action 关键字名称，性感且唯一
description 关键字描述，简短有力
input 传入参数，一个不漏
output 返回参数，暂未实现
steps 执行步骤
关键字定义：

common_action:        
 description: 公共方法
 input: [key,value]
 output: []
 steps:
    - click(${value})
    - sleep(5)

common_action1:        
 description: 公共方法1
 input: [key,value]
 output: []
 steps:
    - click(${value})
    - sleep(5)

调用方式：在用例中call + 关键字名称为调用该关键字的语法，参数个数应和 input 相对应

- call common_action('key','测试数据')

Scripts 脚本函数

Scripts 为Python脚本目录，在 [data.json]下 keywords 中注册方法名后，就可直接在用例中调用脚本如现有关键字无法完成的特殊操作，可以导入框架中 driver 模块，通过 driver 调用底层API
函数定义：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
from fasttest_selenium.driver import *

def getText():
    '''
    调用selenium api获取当前页面标题
    '''
    log_info(driver.title)
    return driver.title

def getTest(test):
    '''
    普通函数
    '''
    log_info(test)

调用方式：如果需要拿到函数返回的数据，可以直接用变量保存，如不需要，可以直接调用函数

- ${title} = getText() # 获取返回值
- getTest('测试数据') # 普通函数

Resource 文件资源

Resource 目录下的文件资源在 data.json 下 resource 中指定文件名称和相对路径后，可以直接在用例中访问该资源文件

- matchImage(${baesImage}, ${baidu_logo})

TestCase 测试用例

TestCase 用于存放测试用例，测试用例为 YAML 文件，如果对YAML 语法不熟悉可参考菜鸟教程，用例结构如下：
module 用例所属业务模块，同一业务下用例的module 应保持一致，在结果报告中它们将展示在同一个分组下面
skip 是否跳过该用例，默认为false
description 用例描述
steps 用例步骤

module: selenium
skip: false
description: action相关
steps:
  - openUrl('https://www.baidu.com')
  # 检查元素
  - check('id=su')
  # 单击元素
  - click('id=su')
  # 右击元素
  - contextClick('id=su')
  # 双击元素
  - doubleClick('class=hot-refresh-text')
  # 按住鼠标左键
  - holdClick('class=hot-refresh-text')

Report 结果报告

Report 为测试结果目录，用例执行完毕后会自动生成高度还原测试用例步骤的测试报告，可点击具体步骤查看截图和错误信息

关键字

测试用例中的关键字包含4中场景，项目结构中已经介绍了自定义关键字 Common 和 Scripts ，接下来两种是固定关键字

讲在前面

在介绍关键字之前，先介绍下用例中经常用到的两个点

关于变量的定义，占位符${} + 变量名test来表示这是一个变量，获取该变量同样如此
1. 关于赋值：它可以直接被赋值或者其他关键字返回值给变量
2. 关于取值：一条用例中${test}会从多个地方尝试获取值，所以具有一定优先级
  1. 最高优先级：如果在for循环中，会优先获取for循环迭代值
  2. 第二优先级：如果for循环中无法获取该变量，会尝试从当前用例中获取变量值
  3. 第三优先级：如果当前用例中未定义该变量，会判断是否在 Common 库中 input 有定义
  4. 第四优先级：如果以上三种均未获取该变量，会尝试从 data.json 下 variable 、 resource 获取变量值
元素定位方法：selenium有八种元素定位方式，为了简化步骤描述，用例中按照 type=element 的方式即可定位到相关元素
1. 元素定位方式：id、name、class、tag_name、link_text、partial_link_text、xpath、css_selector
2. 例：点击百度按钮 click("id=su")

Selenium Action

Browser

打开网页(openUrl)

openUrl 打开一个网页，参数: URL

- ${url} = 'https://www.baidu.com'
- openUrl(${url})
# 或者
- openUrl('https://www.baidu.com')

对应Selenium API ：

driver = webdriver.Chrome()
driver.get(url)

关闭标签页或窗口(close)

close 关闭当前标签页或窗口

- openUrl('https://www.baidu.com')
- close()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.close()

后退(back)

back 退回到上一页

- back()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.find_element_by_xpath('//*[@id="s-top-left"]/a[1]').click()
driver.back()

前进(forward)

forward 前进到下一页

- forward()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.find_element_by_xpath('//*[@id="s-top-left"]/a[1]').click()
driver.back()
driver.forward()

刷新(refresh)

refresh 刷新当前页面

- refresh()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.refresh()

窗口最大化(maxWindow)

maxWindow 窗口最大化

- maxWindow()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.maximize_window()

窗口最小化(minWindow)

minWindow 窗口最小化

- minWindow()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.minimize_window()

窗口全屏(fullscreenWindow)

fullscreenWindow 窗口全屏

- fullscreenWindow()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.fullscreen_window()

设置窗口大小(setWindowSize)

setWindowSize 设置窗口大小，参数： width ， height

- setWindowSize(3000,2000)

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.set_window_size(3000,2000)

设置窗口坐标(setWindowPosition)

setWindowPosition 设置窗口起始坐标，参数： x ， y

- setWindowPosition(10,20)

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.set_window_position(10,20)

获取窗口大小($.getWindowSize)

$.getWindowSize 获取窗口大小

- ${w_size} = $.getWindowSize()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
w_size = driver.get_window_size()

获取窗口坐标($.getWindowPosition)

$.getWindowPosition 获取窗口起始坐标

- ${w_position} = $.getWindowPosition()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
w_position = driver.get_window_position()

获取当前窗口句柄($.getCurrentWindowHandle)

$.getCurrentWindowHandle 获取当前窗口句柄

- ${handle} = $.getCurrentWindowHandle()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
handle = driver.current_window_handle

获取所有窗口句柄($.getWindowHandles)

$.getWindowHandles 获取所有窗口句柄

- ${handles} = $.getWindowHandles()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
handles = driver.window_handles

切换窗口句柄(switchToWindow)

switchToWindow 切换窗口句柄，参数: handle

获取所有的窗口句柄是无序的，建议用for循环切换窗口句柄

- ${all_handle} = $.getWindowHandles()
- for ${handle} in ${all_handle}:
    # 切换窗口句柄
    - switchToWindow(${handle})
    - ${title} = $.getTitle()
    - if ${title} == '百度新闻——海量中文资讯平台':
        - break

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
handles = driver.window_handles
for handle in handles:
    # 切换窗口句柄
    switch_to.window(handle)
    title = driver.title
    if title == '百度新闻——海量中文资讯平台':
        break

获取窗口标题($.getTitle)

$.getTitle 获取窗口标题

- ${title} = $.getTitle()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
title = driver.title

获取窗口URL($.getCurrentUrl)

$.getCurrentUrl 获取窗口URL

- ${title} = $.getCurrentUrl()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
title = driver.current_url

获取浏览器名称($.getName)

$.getName 获取浏览器名称

- ${name} = $.getName()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
title = driver.name

Action

单击(click)

click 鼠标左键单击，参数: element

- click('id=su')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
element.click()

右击(contextClick)

contextClick 鼠标右键单击，参数: element

- contextClick('id=su')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
ActionChains(driver).context_click(element).perform()

双击(doubleClick)

doubleClick 鼠标左键双击，参数: element

- doubleClick('id=su')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
ActionChains(driver).double_click(element).perform()

长按(holdClick)

holdClick 长按鼠标左键不放，参数: element

- holdClick('id=su')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
ActionChains(driver).click_and_hold(element).perform()

拖放元素到另一个元素位置(dragDrop)

dragDrop 拖放元素到另一个元素位置，参数: element，target

- dragDrop('xpath=//*[@id="sbox"]/tbody/tr/td[1]/div[1]/a/img','id=s_btn_wr')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_xpath('//*[@id="sbox"]/tbody/tr/td[1]/div[1]/a/img')
target = find_element_by_id('s_btn_wr')
ActionChains(driver).drag_and_drop(element, target).perform()

拖放元素到某个位置(dragDropByOffset)

dragDropByOffset 拖放元素到某个位置，参数: element ， x ， y

- dragDropByOffset('xpath=//*[@id="sbox"]/tbody/tr/td[1]/div[1]/a/img',10,10)

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_xpath('//*[@id="sbox"]/tbody/tr/td[1]/div[1]/a/img')
ActionChains(driver).drag_and_drop_by_offset(element, 10, 10).perform()

鼠标移动到某个位置(moveByOffset)

moveByOffset 鼠标从当前位置移动到某个坐标，参数：x ， y

- moveByOffset(10,10)

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
ActionChains(driver).move_by_offset(10, 10).perform()

鼠标移动到某个元素(moveToElement)

moveToElement 鼠标移动到某个元素上，参数: element

- moveToElement('xpath=//*[@id="hotsearch-content-wrapper"]/li[1]/a/span[2]')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_xpath('//*[@id="hotsearch-content-wrapper"]/li[1]/a/span[2]')
ActionChains(driver).move_to_element(element).perform()

鼠标_移动到距某个元素多少距离的位置_(moveToElementWithOffset)

moveToElementWithOffset 鼠标_移动到距某个元素(左上角坐标)多少距离的位置_，参数: element ， x ， y

- moveToElementWithOffset('id=su',10,20)

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
ActionChains(driver).move_to_element_with_offset(element, 10, 20).perform()

输入(sendKeys)

sendKeys 输入文案，参数： element ， Keys(可选) ， text

- sendKeys('name=wd','测试文案') # 普通输入
# 复制粘贴
- sendKeys('name=wd','Keys.CONTROL', 'c') # control + c
- sendKeys('name=wd','Keys.CONTROL', 'v') # control + v

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_name('wd')
element.send_keys('测试文案')
# 复制粘贴
element.send_keys(Keys.CONTROL, 'c')
element.send_keys(Keys.CONTROL, 'v')

清除(clear)

clear 清除输入框文案、元素选中状态

- clear('name=wd')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_name('wd')
element.clear()

执行JS(executeScript)

executeScript 执行JS代码，参数: script

- ${js} = "window.open('http://www.taobao.com')"
- executeScript(${js})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
js = "window.open('http://www.taobao.com')"
driver.execute_script(js)

截图($.saveScreenshot)

$.saveScreenshot 对屏幕或者元素截图，参数: element(可选，如果为空则截全屏)， name

# 对元素截图，返回图片路径
- ${path} = $.saveScreenshot('id=su', 'biadu.png')
# 全屏截图，返回图片路径
- ${path} = $.saveScreenshot('biadu.png')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element = find_element_by_id('su')
# 元素截图
element.screenshot(path)
# 全屏截图
driver.save_screenshot(path)

Element

获取单个元素($.getElement)

$.getElement 获取单个元素，参数: element

# 获取单个元素 id|name|class|tag_name|link_text|partial_link_text|xpath|css_selector
- ${element_id} = $.getElement('id=su')
- ${element_name} = $.getElement('name=f')
- ${element_class} = $.getElement('class=s_ipt')
- ${element_tag_name} = $.getElement('tag_name=form')
- ${element_link_text} = $.getElement('link_text=新闻')
- ${element_partial_link_text} = $.getElement('partial_link_text=新')
- ${element_xpath} = $.getElement('xpath=//*[@id="su"]')
- ${element_css_selector} = $.getElement('css_selector=[name="wd"]')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
'''
        by = Dict({
            'id': By.ID,
            'name': By.NAME,
            'xpath': By.XPATH,
            'class': By.CLASS_NAME,
            'tag_name': By.TAG_NAME,
            'link_text': By.LINK_TEXT,
            'css_selector': By.CSS_SELECTOR,
            'partial_link_text': By.PARTIAL_LINK_TEXT,
        })
'''
element_id = find_element(By.ID, 'su')

获取多个元素($.getElement)

$.getElement 获取单个元素，参数: element

# 获取多个元素 id|name|class|tag_name|link_text|partial_link_text|xpath|css_selector
- ${elements_class} = $.getElements('class=title-content-title')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
elements_class = find_elements(By.CLASS_NAME, 'title-content-title')

判断元素是否选中($.isSelected)

$.isSelected 判断元素是否选中，参数: element

- ${element_id} = $.getElement('id=su')
- ${is_selected} = $.isSelected(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
is_selected = element_id.is_selected()

判断元素是否显示($.isDisplayed)

$.isDisplayed 判断元素是否显示，参数: element

- ${element_id} = $.getElement('id=su')
- ${is_displayed} = $.isDisplayed(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
is_displayed = .is_displayed()

判断元素是否可用($.isEnabled)

$.isEnabled 判断元素是否可用，参数: element

- ${element_id} = $.getElement('id=su')
- ${is_enabled} = $.isEnabled(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
is_enabled = element_id.is_enabled()

获取元素大小($.getSize)

$.getSize 判断元素是否选中，参数: element

- ${element_id} = $.getElement('id=su')
- ${size} = $.getSize(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
size = element_id.size

获取元素坐标($.getLocation)

$.getLocation 获取元素坐标，参数: element

- ${element_id} = $.getElement('id=su')
- ${location} = $.getLocation(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
location = element_id.location

获取元素位置大小($.getRect)

$.getRect 获取元素位置大小，参数: element

- ${element_id} = $.getElement('id=su')
- ${rect} = $.getRect(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
rect = element_id.rect

获取元素标签($.getTagName)

$.getTagName 获取元素标签，参数: element

- ${element_id} = $.getElement('id=su')
- ${tag} = $.getTagName(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
tag = element_id.tag_name

获取元素文案($.getText)

$.getText 获取元素位置文案，参数: element

- ${element_id} = $.getElement('id=su')
- ${text} = $.getText(${element_id})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
text = element_id.text

获取元素属性($.getAttribute)

$.getAttribute 获取元素位置属性，参数: element ， attribute

- ${element_id} = $.getElement('id=su')
- ${attribute} = $.getAttribute(${element_id}, 'value')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
attribute = element.get_attribute('value')

获取元素CSS($.getCssProperty)

$.getCssProperty 获取元素CSS，参数: element ， css

- ${element_id} = $.getElement('id=su')
- ${css} = $.getCssProperty(${element_id}, 'height')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
element_id = find_element(By.ID, 'su')
css = element_id.value_of_css_property('height')

Cookie

获取所有Cookie($.getCookies)

$.getCookies 获取所有Cookie

- ${cookies} = $.getCookies()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
cookies = driver.get_cookies()

获取指定Cookie($.getCookie)

$.getCookie 获取指定Cookie，参数: name

- ${cookie} = $.getCookie('BAIDUID')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
cookie = driver.get_cookie('BAIDUID')

删除指定Cookie(deleteCookie)

deleteCookie 删除指定Cookie，参数: name

- deleteCookie('BAIDUID')

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.delete_cookie('BAIDUID')

删除所有Cookie(deleteAllCookies)

deleteAllCookies 删除所有Cookie

- deleteAllCookies()

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
driver.delete_all_cookies()

添加指定Cookie(addCookie)

addCookie 添加指定Cookie，参数: cookie

- ${add_cookie} = {'name':'ADDCOOKIE','value':'123adc'}
- addCookie(${add_cookie})

对应Selenium API：

driver = webdriver.Chrome()
driver.get(url)
add_cookie = {'name':'ADDCOOKIE','value':'123adc'}
driver.add_cookie(add_cookie)

Other Action

变量(${variables})

关于变量已经在开头介绍过，这里演示变量几种写法

# 直接赋值
- ${t1} = 1
- ${t2} = '2'
- ${t3} = "3"
- ${t4} = True
- ${t5} = False
- ${t6} = None
- ${t7} = [1,2,3]
- ${t8} = {'key':'value'}
# 调用方法返回
- ${elements} = $.getElements('class=title-content-title')

如果变量值为列表或字典，可以指定index或者key来获取其中某一个元素的值

- keyDown(${7}[0], ${t8}['key'])

设置全局变量(setVar)**

setVar 设置全局变量，该变量在整个测试执行结束后才会销毁，参数： key ， value

- setVar('key','测试')

获取全局变量($.getVar)**

$.getVar 获取全局变量，参数： key

- ${test} = $.getVar('key')

获取长度($.getLen)

$.getLen 可以获取其他变量的长度，这对于循环是有帮助的，参数： variables

- ${t7} = [1,2,3]
- ${len} = $.getLen(${t7})

睡眠(sleep)

sleep 在当前步骤等待指定时间，参数： s

- sleep(5) # 等待5s

断言(assert)

assert 用例中可以直接断言来检查执行是否符合预期效果，参数：条件表达式

- assert 5 > 4
- ${text} = '测试文案'
- assert '文案' == ${text}
- assert '文案' in '测试文案'

执行表达式($.id)

$.id 用于执行一个表达式，参数：表达式

- ${index} = $.id(1+1) # 2
- ${str} = $.id('测试'+'文案') # 测试文案

条件语句(if、elif、else)

if 、 elif 、 else 根据条件表达式来决定执行代码，参数：条件表达式

- ${index} = $.id(1+1) # 2
- if ${index} == 2:
    - ${test} = 1
  elif ${index} > 2:
    - ${test} = 2
  else:
    - ${test} = 3

循环语句(while)

while 用于循环执行程序，参数：条件表达式 break 在某一条件成立时，可以跳出循环

- ${list} = [1,2,3,4]
- ${len} = $.getLen(${list})
- while ${len}:
    - ${len} = $.id(${len}-1)
    - if ${list}[${len}] == 2:
      - break

循环语句(for)

for 循环可以遍历任何序列的项目，如一个列表或者一个字符串，参数： 可迭代对象 break 在某一条件成立时，可以跳出循环

# 打开URL
- openUrl('https://www.baidu.com')
# 打开一个新窗口  
- click('xpath=//*[@id="s-top-left"]/a[1]')
# 获取所有窗口句柄
- ${all_handle} = $.getWindowHandles()
# for 循环
- for ${handle} in ${all_handle}:
    # 切换窗口句柄
    - switchToWindow(${handle})
    - ${title} = $.getTitle()
    - if ${title} == '百度新闻——海量中文资讯平台':
        - break

End

Project details

These details have not been verified by PyPI

Project links

Homepage

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Release history Release notifications | RSS feed

This version

0.1.6

Jan 27, 2021

0.1.5

Jan 17, 2021

0.1.4

Jan 11, 2021

0.1.3

Jan 10, 2021

0.1.2

Jan 7, 2021

0.1.1

Jan 5, 2021

0.1.0

Jan 3, 2021

0.0.9

Dec 30, 2020

0.0.8

Dec 29, 2020

0.0.7

Dec 21, 2020

0.0.5

Dec 20, 2020

0.0.4

Dec 19, 2020

0.0.3

Dec 14, 2020

0.0.2

Dec 13, 2020

0.0.1

Dec 12, 2020

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fasttest-selenium-0.1.6.tar.gz (50.6 kB view hashes)

Uploaded Jan 27, 2021 Source

Built Distribution

fasttest_selenium-0.1.6-py3-none-any.whl (45.8 kB view hashes)

Uploaded Jan 27, 2021 Python 3

Hashes for fasttest-selenium-0.1.6.tar.gz

Hashes for fasttest-selenium-0.1.6.tar.gz
Algorithm	Hash digest
SHA256	`d5f87dc0cdeb70f0f89731c6df6a81d52cbb07656baa29966daa2d106cb564d4`
MD5	`e8e47ab960922e3e4a8154acc06eb035`
BLAKE2b-256	`315907784992988d65490639762c3f4d68adca7cfefa1109547600f2c67d72a9`

Hashes for fasttest_selenium-0.1.6-py3-none-any.whl

Hashes for fasttest_selenium-0.1.6-py3-none-any.whl
Algorithm	Hash digest
SHA256	`369222e33599767e2b78475dd264f400b63b19bf99a6a53c37cfac7990c0904e`
MD5	`b97934d562069ab3c4b5217a10a9870c`
BLAKE2b-256	`a49c0aaaa95c58591a088c90a4943165f1b2cc74de2915cd38f6fc43d4c44b30`

fasttest-selenium 0.1.6

Navigation

Verified details

Maintainers

Unverified details

Project links

GitHub Statistics

Meta

Classifiers

Project description

框架介绍

idea

已完成功能

待完成功能

快速体验

框架下载

项目依赖

测试Demo

项目结构

项目树状图

config 项目配置

data 数据配置

runtest 执行入口

Common 自定义关键字

Scripts 脚本函数

Resource 文件资源

TestCase 测试用例

Report 结果报告

关键字

讲在前面

Selenium Action

Browser

打开网页(openUrl)

关闭标签页或窗口(close)

后退(back)

前进(forward)

刷新(refresh)

窗口最大化(maxWindow)

窗口最小化(minWindow)

窗口全屏(fullscreenWindow)

设置窗口大小(setWindowSize)

设置窗口坐标(setWindowPosition)

获取窗口大小($.getWindowSize)

获取窗口坐标($.getWindowPosition)

获取当前窗口句柄($.getCurrentWindowHandle)

获取所有窗口句柄($.getWindowHandles)

切换窗口句柄(switchToWindow)

获取窗口标题($.getTitle)

获取窗口URL($.getCurrentUrl)

获取浏览器名称($.getName)

Action

单击(click)

右击(contextClick)

双击(doubleClick)

长按(holdClick)

拖放元素到另一个元素位置(dragDrop)

拖放元素到某个位置(dragDropByOffset)

鼠标移动到某个位置(moveByOffset)

鼠标移动到某个元素(moveToElement)

鼠标_移动到距某个元素多少距离的位置_(moveToElementWithOffset)

输入(sendKeys)

清除(clear)

执行JS(executeScript)

截图($.saveScreenshot)

Element

获取单个元素($.getElement)

获取多个元素($.getElement)

判断元素是否选中($.isSelected)

判断元素是否显示($.isDisplayed)

判断元素是否可用($.isEnabled)

获取元素大小($.getSize)

获取元素坐标($.getLocation)

获取元素位置大小($.getRect)

获取元素标签($.getTagName)

获取元素文案($.getText)

获取元素属性($.getAttribute)

获取元素CSS($.getCssProperty)

Cookie

获取所有Cookie($.getCookies)

获取指定Cookie($.getCookie)