selenium 常用API

• 引入
  • from selenium import webdriver
  • from selenium.webdriver.common.action_chains import ActionChains
  • from selenium.webdriver.common.keys import Keys
  • from selenium.webdriver.support.wait import WebDriverWait
  • from selenium.webdriver.support import expected_conditions as EC
  • from time import sleep
  • import os
• 创建一个浏览器
  • dr = webdriver.Chrome()
• 访问某个网址
  • dr.get('https://www.baidu.com')
• 设置浏览器的宽高
  • dr.set_window_size(200, 200)　　# 设置浏览器的宽高为200px
• 设置浏览器全屏、最小化
  • dr.maximize_window()　 # 全屏
  • dr.minimize_window()　　 # 最小化
• 网页前进、后退
  • dr.forward() # 前进
  • dr.back()　 # 后退
• 关闭
  • dr.close() # 关闭标签页
  • dr.quit() # 关闭浏览器
• 简单元素操作
  • 元素.clear() # 清除元素输入框的内容
  • 元素.send_keys('hello') # 在元素输入框中输入hello
  • 元素.click() # 点击某元素按钮
• 常用API
  • 表单元素.submit() # 用于form元素，模拟按下enter键来替代点击操作
  • 元素.size() # 获取元素的尺寸大小
  • 元素.text # 获取元素的文本内容
  • 元素.get_attribute('name') # 获取元素的name属性值
  • 元素.is_displayed() # 判断元素是否可见，返回布尔值
• 鼠标事件（引入ActionChains）
  • ActionChains(dr).context_click(元素).perform() # 右键
  • ActionChains(dr).double_click(元素).perform() # 双击
  • ActionChains(dr).move_to_element(元素).perform() # 鼠标悬停
  • ActionChains(dr).drag_and_drop(source, target).perform() # 将source元素拖拽到target元素位
  • ActionChains(dr).drag_and_drop(source, x, y).perform() # 将source元素相对于自己的位置拖拽
• 键盘事件（引入Keys ）
  • driver.find_element_by_id("kw").send_keys("seleniumm") # 输入内容selenium
  • driver.find_element_by_id("kw").send_keys(Keys.BACK_SPACE) # 退格
  • driver.find_element_by_id("kw").send_keys(Keys.SPACE) # 空格键
  • driver.find_element_by_id("kw").send_keys(Keys.CONTROL,'a') # 全选输入框内容
  • driver.find_element_by_id("kw").send_keys(Keys.CONTROL,'x') # 剪切输入框内容
  • driver.find_element_by_id("kw").send_keys(Keys.CONTROL,'v') # 粘贴内容到输入框
  • driver.find_element_by_id("kw").send_keys(Keys.CONTROL,'c') # 复制选中的内容
  • driver.find_element_by_id("su").send_keys(Keys.ENTER) # 回车操作代替点击按钮
  • driver.find_element_by_id("su").send_keys(Keys.ESCAPE) # 退出按钮
  • driver.find_element_by_id("su").send_keys(Keys.TAB) # 制表键
  • driver.find_element_by_id("su").send_keys(Keys.F1) # 按下键盘F1
• 元素等待（引入WebDriverWait、expected_conditions）
  • 显示等待
    • WebDriverWait(self.dr, 5, 0.3).until(EC.presence_of_element_located((By.ID, "msg"))) # 等待5秒钟，每隔0,3秒钟询问一次，直到出现id为msg的元素
    • WebDriverWait(dr, 5, 0.1).until_not(ec.text_to_be_present_in_element((By.CSS_SELECTOR, '#chaptercontent'),U'正在转码，请稍后......')) # 等待5秒钟，每隔0.1秒询问一次，直到id为chaptercontent的元素文本内容不是“正在转码，请稍后......”
    • title_is # 用于判断标题是否 xx
    • title_contains # 用于判断标题是否包含 xx 信息
    • presence_of_element_located # 元素是否存在
    • visibility_of_element_located # 元素是否可见
    • visibility_of # 是否可见
    • presence_of_all_elements_located # 判断一组元素的是否存在
    • text_to_be_present_in_element # 判断元素是否有 xx 文本信息
    • text_to_be_present_in_element_value # 判断元素值是否有 xx 文本信息
    • frame_to_be_available_and_switch_to_it # 框架是否可用，并切换到该框架
    • invisibility_of_element_located # 判断元素是否隐藏
    • element_to_be_clickable # 判断元素是否点击，它处于可见和启动状态
    • staleness_of # 等到一个元素不再是依附于 DOM
    • element_to_be_selected #被选中的元素
    • element_located_to_be_selected # 一个期望的元素位于被选中
    • element_selection_state_to_be # 一个期望检查如果给定的元素被选中
    • element_located_selection_state_to_be # 期望找到一个元素并检查是否选择状态
    • alert_is_present # 预期一个警告信息
  • 隐式等待
    • dr.implicitly_wait(10) # 等待10秒钟，若提前结束就停止等待，若超时就抛出异常
  • sleep（引出sleep）
    • time.sleep(10) # 傻傻的等待10秒钟，不管是否提前结束
• 框架的切换
  • dr.switch_to.frame("if") # 切换到id或者name为if的框架
  • dr.switch_to.frame(frame) # 若无法用name 或者 id定位到框架，则可以先用其他方式定位获取到框架元素，再将这个元素传入switch_to..frame()里
  • dr.switch_to_default.content() # 切换到默认的框架中
• 窗口的切换
  • dr.current_window_handle # 获取当前窗口的句柄，切换到js弹框上
  • dr.window_handles 　　　　 # 获取所有窗口的句柄
  • dr.switch_to.window() 　　　　　　　　　　　　　　　　　　　　　 # 切换到某个窗口
• 警告框
  • dr.switch_to.alert # 切换到弹框（alert、prompt、confirm）
  • dr.switch_to.alert.text # 获取弹框的文本内容
  • dr.switch_to_alert.accept()　　 # 切换到弹框并且点击“确认”
  • dr.switch_to.alert.dismiss # 切换到弹框并且点击“取消”
  • dr.switch_to.alert.sendkeys('hello') # 切换到弹框并且在输入框中输入‘hello’
• 上传文件(引入 os)
  • file = os.path.abspath('1.jpg') # 相对于该py文件的图片对象
  • dr.find_element(By.ID, 'upfile2').send_keys(file) # 将图片传入id为upfile2的元素里
• 调用js
  • js="var q=document.documentElement.scrollTop=10000" # 编写js代码：将页面的滚动条向下移动10000px
    dr.execute_script(js) # 执行编写好的js代码
• 窗口截图
  • dr.get_screenshot_as_file("D:\baidu_error.jpg") # 将当前页面可视区截图并存放命名为D:\baidu_error.jpg