一、操作目的
1.1 自动化测试常用操作
1、定位网页上的元素,并存储到一个变量中;
2、对变量进行操作,比如点击或输入文字;
3、设定页面元素的操作值;
二、定位方法汇总
2.1 findElement(s)
click(self, on_element=None)
click_and_hold(self, on_element=None)
context_click(self, on_element=None)
double_click(self, on_element=None)
drag_and_drop(self, source, target)
drag_and_drop_by_offset(self, source, xoffset, yoffset)
key_down(self, value, element=None)
key_up(self, value, element=None)
move_by_offset(self, xoffset, yoffset)
move_to_element(self, to_element)
move_to_element_with_offset(self, to_element, xoffset, yoffset)
pause(self, seconds)
perform(self)
release(self, on_element=None)
reset_actions(self)
send_keys(self, *keys_to_send)
send_keys_to_element(self, element, *keys_to_send)
2.2、selenium.webdriver.common.by
CLASS_NAME = 'class name'
CSS_SELECTOR = 'css selector'
ID = 'id'
LINK_TEXT = 'link text'
NAME = 'name'
PARTIAL_LINK_TEXT = 'partial link text'
TAG_NAME = 'tag name'
XPATH = 'xpath'
2.3、selenium.webdriver.common.keys
ADD = 'ue025'
ALT = 'ue00a'
ARROW_DOWN = 'ue015'
ARROW_LEFT = 'ue012'
ARROW_RIGHT = 'ue014'
ARROW_UP = 'ue013'
BACKSPACE = 'ue003'
BACK_SPACE = 'ue003'
CANCEL = 'ue001'
CLEAR = 'ue005'
COMMAND = 'ue03d'
CONTROL = 'ue009'
DECIMAL = 'ue028'
DELETE = 'ue017'
DIVIDE = 'ue029'
DOWN = 'ue015'
END = 'ue010'
ENTER = 'ue007'
EQUALS = 'ue019'
ESCAPE = 'ue00c'
F1 = 'ue031'
F10 = 'ue03a'
F11 = 'ue03b'
F12 = 'ue03c'
F2 = 'ue032'
F3 = 'ue033'
F4 = 'ue034'
F5 = 'ue035'
F6 = 'ue036'
F7 = 'ue037'
F8 = 'ue038'
F9 = 'ue039'
HELP = 'ue002'
HOME = 'ue011'
INSERT = 'ue016'
LEFT = 'ue012'
LEFT_ALT = 'ue00a'
LEFT_CONTROL = 'ue009'
LEFT_SHIFT = 'ue008'
META = 'ue03d'
MULTIPLY = 'ue024'
NULL = 'ue000'
NUMPAD0 = 'ue01a'
NUMPAD1 = 'ue01b'
NUMPAD2 = 'ue01c'
NUMPAD3 = 'ue01d'
NUMPAD4 = 'ue01e'
NUMPAD5 = 'ue01f'
NUMPAD6 = 'ue020'
NUMPAD7 = 'ue021'
NUMPAD8 = 'ue022'
NUMPAD9 = 'ue023'
PAGE_DOWN = 'ue00f'
PAGE_UP = 'ue00e'
PAUSE = 'ue00b'
RETURN = 'ue006'
RIGHT = 'ue014'
SEMICOLON = 'ue018'
SEPARATOR = 'ue026'
SHIFT = 'ue008'
SPACE = 'ue00d'
SUBTRACT = 'ue027'
TAB = 'ue004'
UP = 'ue013'
2.4、selenium.webdriver.Chrome
函数 | 描述 |
---|---|
back() |
返回 |
close() |
关闭当前窗口 |
delete_all_cookies() |
删除所有 cookies |
delete_cookie('name') |
按名字删除 cookie |
find_element(by='id', value=None) |
查找给定标识符的元素 |
find_element_by_class_name('name') |
通过类名来定位元素 |
find_element_by_css_selector('css_selector') |
通过 css 选择器来定位元素 |
find_element_by_id('id') |
通过 id 来定位元素 |
find_element_by_link_text('link_text') |
通过链接内容来定位元素 |
find_element_by_partial_link_text('link_text') |
通过链接部分内容来定位元素 |
find_element_by_name('name') |
通过元素名称来定位元素 |
find_element_tag_name('name') |
通过标签名来定位元素 |
find_element_by_xpath('xpath') |
通过 xpath 来定位元素 |
find_elements(by='id', value=None) |
|
find_elements_by_class_name('name') |
|
find_elements_by_css_selector('css_selector') |
|
find_elements_by_id('id') |
|
find_elements_by_link_text('text') |
|
find_elements_by_partial_link_text('link_text') |
|
find_elements_by_name('name') |
|
find_elements_by_tag_name('name') |
|
find_elements_by_xpath('xpath') |
|
forward() |
向前 |
fullscreen_window() |
全屏 |
get('url') |
访问 url 页面 |
get_cookie(''name') |
通过名称获取 cookie |
get_cookies() |
获取所有 cookies |
get_log('log_type') |
获取日志,类型有:browser 、driver 、client 、server |
get_screenshot_as_base64(self) |
获取图片存为 base64 编码 |
get_screenshot_as_file('file_name') |
获取图片存为文件,需要指定文件名,png 后缀 |
get_screenshot_as_png() |
将图片存为二进制数据 |
get_window_position(windowHandle='current') |
获取当前窗口的 x,y 位置 |
get_window_rect() |
获取 x,y 坐标和当前窗口的宽高 |
get_window_size(windowHandle='current') |
获取当前窗口的宽高 |
implicitly_wait('time_to_wait) |
隐式等待一个元素加载或命令执行完成的时间。 |
maximize_window() |
最大化 |
minimize_window() |
最小化 |
refresh() |
刷新 |
save_screenshot('findname') |
保存屏幕截图 |
set_page_load_timeout('time_to_wait') |
|
set_script_timeout('time_to_wait') |
|
set_window_position(x, y, windowHandle='current') |
|
set_window_rect(x, y, width, height) |
|
set_window_size(width, height, windowHandle='current') |
|
start_client() |
|
start_session(capabilities, browser_profile=None) |
|
stop_client() |
|
switch_to_active_element() |
|
switch_to_alert() |
|
switch_to_default_content() |
|
switch_to_frame('frame_reference') |
切换到指定框架 |
switch_to_window('window_name') |
切换到指定窗口 |
那么总的来说,查找元素分为以下两类:
1、查到单个元素
find_element_by_id
find_element_by_name
find_element_by_xpath
find_element_by_link_text
find_element_by_partial_link_text
find_element_by_tag_name
find_element_by_class_name
find_element_by_css_selector
2、查找多个元素(返回列表)
find_elements_by_name
find_elements_by_xpath
find_elements_by_link_text
find_elements_by_partial_link_text
find_elements_by_tag_name
find_elements_by_class_name
find_elements_by_css_selector
上面的是公有方法,还有两个私有方法是:
find_element()
find_elements()
# 这两个方法使用的时候,需要提供两个参数
# 一个是 By.xx ,这里的 xx 分别是上面列出的几种定位方法的大写
# 比如 find_element(By.ID, 'su')
# 比如 find_element(By.CSS_SELECTOR, 'h1')
三、编写实际代码测试
3.1 元素定位
// id 定位
WebElement username = driver.findElement(By.id("username"));
// name 定位
WebElement username = driver.findElement(By.name("username"));
// 部分链接文字定位
WebElement link = driver.findElement(By.partialLinkText("sog"));
// 使用标签名定位
WebElement link = driver.findElement(By.tagName("a"));
// 使用 class 名定位
WebElement input = driver.findElement(By.className("tight"));
// 使用xpath定位
WebElement button = driver.findElement(By.xpath("/html/body/div/input[@value='查询']"));
// 上述xpath使用的是绝对路径定位,当页面发生变化时,很容易造成代码失效。
// 所以推荐使用相对路径,比如将上述定位改成:"//input[@value='查询']"
// 如果定位元素是列表时,下标从1开始
// css定位
WebElement button = driver.findElement(By.cssSelector("input#div > input#ok"));
WebElement button = driver.findElement(By.cssSelector("input#div > input + a + img"));
WebElement button = driver.findElement(By.cssSelector("input:nth-child(2)"));
WebElement button = driver.findElement(By.cssSelector("input#div :nth-child(2)"));
WebElement button = driver.findElement(By.cssSelector("a['href' ^= 'http://www.baidu.com']"));
// ^= 匹配开头,$= 匹配结尾 *= 链接含有即匹配中
xpath模糊定位
xpath函数 | 定位表达式 | 解释 |
---|---|---|
Starts-with() | //img[starts-with(@alt,'div1')] | 查找图片alt属性开始位置包含“div1“关键字的页面元素 |
Contains() | //img[contains(@alt,'g1')] | 查找图片alt属性包含“gl“关键字的页面元素 |
XPath 轴(Axis)定位:
关键字 | 含义 | 实例 | 解释 |
---|---|---|---|
parent | 选择当前节点的上层节点 | //img[@alt='ok']/parent::div | 查找alt属性为ok的图片,然后向定位上层div元素 |
child | |||
ancestor | 所有上层节点 | ||
descendant | 所有下层节点 | ||
following | 当前节点之后所有节点 | ||
following-sibling | 后面所有同级节点 | ||
preceding | 当前节点之前所有节点 | ||
preceding-sibling | 前面所有同级节点 |