Selenium
Selenium
基本操作
Selenium 是一个自动化测试工具,利用它可以驱动浏览器执行特定的动作,如点击、下拉等操作,同时还可以获取浏览器当前呈现的页面的源代码,做到可见即可爬。对于一些 JavaScript 动态渲染的页面来说,此种抓取方式非常有效。
导入
|
|
声明浏览器对象
|
|
其他操作
|
|
Cookies 操作
获取 Cookies
.get_cookies()
- 返回现有 Cookies
删除 Cookies
.delete_all_cookies()
- 删除现有 Cookies
添加 Cookies
.add_cookie(dic_cookies)
- dic_cookies:字典形式的 Cookies
页面操作
页面操作以浏览器为对象
前进后退
.forward() .back()
|
|
连续访问 3 个页面,然后调用 back()
方法回到第二个页面,接下来再调用 forward()
方法又可以前进到第三个页面。
标签页操作
打开新标签页
.execute_script(‘window.open()’)
查看标签页
.window_handles
- 返回标签页列表
切换标签页
.switch_to_window(window_value)
- window_value:标签页名
切换 Frame
.switch_to_frame(window_value)
网页中有一种节点叫作 iframe,也就是子 Frame,相当于页面的子页面,它的结构和外部网页的结构完全一致。Selenium 打开页面后,它默认是在父级 Frame 里面操作,而此时如果页面中还有子 Frame,它是不能获取到子 Frame 里面的节点的
|
|
延时等待
在 Selenium 中,get()
方法会在网页框架加载结束后结束执行,此时如果获取 page_source
,可能并不是浏览器完全加载完成的页面,如果某些页面有额外的 Ajax 请求,我们在网页源代码中也不一定能成功获取到。所以,这里需要延时等待一定时间,确保节点已经加载出来
隐式等待
.implicitly_wait(seconds)
如果 Selenium 没有在 DOM 中找到节点,将继续等待,超出设定时间后,则抛出找不到节点的异常
隐式等待的效果其实并没有那么好,因为我们只规定了一个固定时间,而页面的加载时间会受到网络条件的影响
显式等待
先指定要查找的节点,然后指定一个最长等待时间。如果在规定时间内加载出来了这个节点,就返回查找的节点;如果到了规定时间依然没有加载出该节点,则抛出超时异常
生成器
WebDriverWait(driver,timeout,poll_frequency=0.5,ignored_exceptions=None)
- driver:浏览器驱动
- timeout:最长超时时间,默认以秒为单位
- poll_frequency:检测的间隔步长,默认为 0.5s
- ignored_exceptions:超时后的抛出的异常信息,默认抛出 NoSuchElementExeception 异常。
|
|
直到函数
until(method) 和 until_not(method)
以显示等待为对象
method:expected_conditions
|
|
等待条件
(expected_conditions)
方法 | 说明 |
---|---|
title_is | 判断当前页面的 title 是否完全等于(==)预期字符串,返回布尔值 |
title_contains | 判断当前页面的 title 是否包含预期字符串,返回布尔值 |
presence_of_element_located | 判断某个元素是否被加到了 dom 树里,并不代表该元素一定可见 |
visibility_of_element_located | 判断元素是否可见(可见代表元素非隐藏,并且元素宽和高都不等于 0) |
visibility_of | 同上一方法,只是上一方法参数为locator,这个方法参数是 定位后的元素 |
presence_of_all_elements_located | 判断是否至少有 1 个元素存在于 dom 树中。举例:如果页面上有 n 个元素的 class 都是’wp’,那么只要有 1 个元素存在,这个方法就返回 True |
text_to_be_present_in_element | 判断某个元素中的 text 是否 包含 了预期的字符串 |
text_to_be_present_in_element_value | 判断某个元素中的 value 属性是否包含 了预期的字符串 |
frame_to_be_available_and_switch_to_it | 判断该 frame 是否可以 switch进去,如果可以的话,返回 True 并且 switch 进去,否则返回 False |
invisibility_of_element_located | 判断某个元素中是否不存在于dom树或不可见 |
element_to_be_clickable | 判断某个元素中是否可见并且可点击 |
staleness_of | 等某个元素从 dom 树中移除,注意,这个方法也是返回 True或 False |
element_to_be_selected | 判断某个元素是否被选中了,一般用在下拉列表 |
element_selection_state_to_be | 判断某个元素的选中状态是否符合预期 |
element_located_selection_state_to_be | 跟上面的方法作用一样,只是上面的方法传入定位到的 element,而这个方法传入 locator |
alert_is_present | 判断页面上是否存在 alert |
异常
如果网络有问题,在设定时间内内没有成功加载,那就抛出 TimeoutException
异常
节点操作
节点操作均以节点为对象
查找结点
单个节点
返回元素节点,为 WebElement
类型
分类方法
.find_element_by_XXX()
|
|
例
|
|
通用方法
.find_element(By.XXX, value)
|
|
多个节点
如果要查找所有满足条件的节点,需要用 find_elements()
这样的方法。
返回节点列表,每个节点都是 WebElement
类型。
获取节点信息
基本信息
.get_attribute(value)
- 获取属性 Gets the given attribute or property of the element.
- value:属性名
.text
- 获取文本
.id
- 获取 id,Internal ID used by selenium.
.location
- 节点在页面中的相对位置,The location of the element in the renderable canvas.
.size
- 获取节点大小(宽高),The size of the element.
.tag_name
- 获取标签名称,This element’s
tagName
property.
- 获取标签名称,This element’s
判断操作
is_displayed()
- 是否可见,Whether the element is visible to a user.
is_enabled()
- 是否可使用,Returns whether the element is enabled.
is_selected()
- 是否被选中,Returns whether the element is selected.Can be used to check if a checkbox or radio button is selected.
交互操作
Selenium 可以驱动浏览器来执行一些操作,也就是说可以让浏览器模拟执行一些动作
节点操作
以节点为对象的操作
.send_keys(value)
- 选定元素进行输入,Simulates typing into the element.
- value:输入的值,可以是字符串也可以是
Keys
类型
.clear()
- 清空输入框 Clears the text if it’s a text entry element.
.click()
- 点击元素,Clicks the element
.submit()
- 提交,Submits a form.
.screenshot(path)
- 节点截图,Saves a screenshot of the current element to a PNG image file.
- path:路径
- usage:
element.screenshot(‘/Screenshots/foo.png’)
动作链
还有另外一些操作,它们没有特定的执行对象,比如鼠标拖曳、键盘按键等,这些动作用动作链来执行
|
|
拖曳
.drag_and_drop(source, target)
- 元素拖曳到另一个元素
- source:起始节点
- target:终止节点
.drag_and_drop_by_offset(source, xoffset, yoffset)
元素按偏移量拖曳
source:The element to mouse down.
xoffset:X offset to move to.
yoffset:Y offset to move to.
点击
.click(on_element=None)
- 点击元素,Clicks an element
- on_element:The element to click. If None, clicks on current mouse position
.click_and_hold()
- 按住元素,Holds down the left mouse button on an element.
.release()
- 释放,Releasing a held mouse button on an element.
.context_click()
- 右键单击元素,Performs a context-click (right click) on an element.
.double_click()
- 双击元素,Double-clicks an element.
键盘操作
.key_down(value)
按下不放,Sends a key press only, without releasing it.
Should only be used with modifier keys (Control, Alt and Shift).
value:
Keys
对象,The modifier key to send.usage:
ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()
(pressing ctrl+c:)
.key_up(value)
- 松开,Releases a modifier key.
- value:
Keys
对象,The modifier key to send.
移动
.move_to_element(to_element)
- 将光标移至元素中央,Moving the mouse to the middle of an element.
- to_element:The WebElement to move to.
.move_to_element_with_offset(to_element, xoffset, yoffset)
将光标移动指定偏移量,Move the mouse by an offset of the specified element.
Offsets are relative to the top-left corner of the element.
to_element:The WebElement to move to.
xoffset:X offset to move to.
yoffset:Y offset to move to.
发送按键
- .send_keys(keys_to_send)
- 发送,Sends keys to current focused element.
- keys_to_send:
Keys
对象,The keys to send. Modifier keys constants can be found in the ‘Keys’ class.
- .send_keys_to_element(element, keys_to_send)
- 发送到指定节点,Sends keys to an element.
- element:The element to send keys.
- keys_to_send:
Keys
对象
执行 JavaScript
browser.execute_script(JS_action)
- JS_action:jS 指令
例
|
|
Keys 对象
我们经常需要模拟键盘的输入,当输入普通的值时,在 send_keys()方法中传入要输入的字符串就好了。
但是我们有时候会用到一些特殊的按键,这时候就需要用到我们的 Keys 类
例
|
|
按键
|
|
常见操作
- 设置浏览器类的 options 选项
|
|
- 弹出框的处理 switch_to.alert
|
|