python-selenium

selenium

【一】安装python3

https://www.runoob.com/python3/python3-install.html

• centos7安装python3:

yum update

yum install python3

yum install python3-pip

安装selenium库
pip3 install selenium

• ubuntu安装python3:

pat-get update

apt-get install python3

apt-get install python3-pip

安装selenium库
pip3 install selenium

【二】介绍

Selenium是一个用于Web应用程序自动化测试工具。Selenium测试直接运行在浏览器中，就像真正的用户在操作一样。支持的浏览器包括IE（7, 8, 9, 10, 11），Mozilla Firefox，Safari，Google Chrome，Opera等。

主要功能包括：测试与浏览器的兼容性——测试你的应用程序看是否能够很好得工作在不同浏览器和操作系统之上。

测试系统功能——创建回归测试检验软件功能和用户需求。支持自动录制动作和自动生成 .Net、Java、Perl等不同语言的测试脚本。

Selenium也是一款同样使用Apache License 2.0协议发布的开源框架。

【三】API

3.1 API:

https://selenium.dev/selenium/docs/api/py/api.html

3.2 Selenium-WebDriverApi接口详解

• 创建运行

         chrome_driver = “xxxxx"

        # 无头形式运行
        # chrome_options = Options()
        # chrome_options.add_argument('--headless')
        # chrome_options.add_argument('--no-sandbox')
        # driver = webdriver.Chrome(chrome_options=chrome_options, executable_path=chrome_driver)

        # 打开本地浏览器运行
        driver = webdriver.Chrome(executable_path=chrome_driver)
        driver.maximize_window()

• 浏览器操作

# 刷新
driver.refresh()
 
# 前进
driver.forward()
 
# 后退
driver.back()

• 获取标签元素

# 通过ID定位目标元素
driver.find_element_by_id('i1')
 
# 通过className定位目标元素
driver.find_element_by_class_name('c1')
 
# 通过name属性定位目标元素
driver.find_element_by_name('n1')
 
# 通过Xpath定位目标元素
driver.find_element_by_xpath('//*[@id="i1"]')
 
# 通过css Selector定位目标元素
driver.find_element_by_css_selector('#i1')
 
# 通过标签名称定位(注：在一个页面中，标签一定会重复，所以不用这个来进行定位)
driver.find_element_by_tag_name('input')
 
# 通过标签中的文本查找元素
driver.find_element_by_link_text('登录')
 
# 通过标签中文本的模糊匹配查找
driver.find_elements_by_partial_link_text('录')

获取标签元素常用的一共有8种定位方式，而Selenium实际提供了18种定位方式，还有8种是上面的复数形式，这里就不一一介绍了，实际运用中并不常用，还有2种实际上是这上面所说16种的底层封装。参数化的一种调用方式而已

• Cookie操作

# 根据cookieKey，获取cookie信息
cookie = driver.get_cookie('cookieKey')
 
# 获取所有cookie信息
cookies = driver.get_cookies()
 
# 添加cookie，严格按照格式添加，cookie的key为name，value为value
driver.add_cookie({'name':'tmp','value':'123123123'})
 
# 删除所有cookie信息
driver.delete_all_cookies()
 
# 根据cookieKey删除对应cookie
driver.delete_cookie('UiCode')

• 窗口操作

# 获取当前浏览器的大小
driver.get_window_size()
 
# 通过像素设置浏览器的大小
driver.set_window_size('width','height')
 
# 获取当前窗口针对于Windows的位置的坐标x,y
driver.get_window_position()
 
# 设置当前窗口针对Windows的位置，x,y
driver.set_window_position(20,20)
 
# 最大化当前窗口,不需要传参
driver.maximize_window()
 
# 返回当前操作的浏览器句柄
driver.current_window_handle
 
# 返回所有打开server的浏览器句柄
driver.window_handles

• 截取当前页面

# 获取当前页面的二进制图片数据，需要自己去写入文件
driver.get_screenshot_as_png()
 
# as_png的上层封装，只需要传入图片名称自动写成图片
driver.get_screenshot_as_file('fileName.png')

• 执行JavaScript语句

# 执行JavaScript语句
driver.execute_script('JavaScript Commond')
 
# 例：
# 通过js来操作滚动条
# 参数1：x  参数2： y
window.scrollTo(100,400);

• 关闭与退出

# 当开启多个时，关闭当前页面
driver.close()
 
# 退出并关闭所有页面驱动
driver.quit()

• 其他

# 返回页面源码
driver.page_source
 
# 返回tag标题
driver.title
 
# 返回当前Url
driver.current_url
 
# 获取浏览器名称 如：chrome
driver.name

• ElementApi接口

# 根据标签属性名称,获取属性value
element.get_attribute('style')
 
# 向输入框输入字符串 如果input的type为file类型 可以输入文件绝对路径上传文件
element.send_keys()
 
# 清除文本内容
element.clear()
 
# 鼠标左键点击操作
element.click()
 
# 通过属性名称获取属性
element.get_property('id')
 
# 返回元素是否可见 True or False
element.is_displayed()
 
# 返回元素是否被选中 True or False
element.is_selected()
 
# 返回标签元素的名字
element.tag_name
 
# 获取当前标签的宽和高
element.size
 
# 获取元素的文本内容
element.text
 
# 模仿回车按钮 提交数据
element.submit()
 
# 获取当前元素的坐标
element.location
 
# 截取图片
element.screenshot()

• 常见异常

　  NoSuchElementException：没有找到元素
 
　　NoSuchFrameException：没有找到iframe
 
　　NoSuchWindowException:没找到窗口句柄handle
 
　　NoSuchAttributeException:属性错误
 
　　NoAlertPresentException：没找到alert弹出框
 
　　ElmentNotVisibleException：元素不可见
 
　　ElementNotSelectableException：元素没有被选中
 
　　TimeoutException：查找元素超时

• 键盘事件：

from selenium.webdriver.common.keys import Keys

【四】demo

• 主函数入口

from com.feng.xhrtas.rtas import *

if __name__ == '__main__':
    rtas = Rtas()
    rtas.run()

• element_util

from retrying import retry
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions
from selenium.webdriver.common.by import By

@retry(stop_max_attempt_number=4)
def get_element(driver,xpath):
    """
    通过xpath获取元素
    :param driver:
    :param xpath:
    :return:
    """
    #element = driver.find_element_by_xpath(xpath)
    element = WebDriverWait(driver, 4).until(expected_conditions.presence_of_element_located((By.XPATH, xpath)))
    if element is not None:
        return element
    return None


def onclick_element(driver,xpath):
    """
    点击元素
    :param driver:
    :param xpath:
    """
    element = get_element(driver,xpath)
    if element is not None:
        driver.execute_script("arguments[0].click();", element)

• showdoc

from selenium import webdriver
from com.feng.xhrtas.login import *
from com.feng.xhrtas.wiki import *

class Rtas:
    def __init__(self) -> None:
        self.chrome_driver = rtas_const.chrome_driver

        # 无头形式运行
        # chrome_options = Options()
        # chrome_options.add_argument('--headless')
        # chrome_options.add_argument('--no-sandbox')
        # self.driver = webdriver.Chrome(chrome_options=chrome_options, executable_path=self.chrome_driver)

        # 打开本地浏览器运行
        self.driver = webdriver.Chrome(executable_path=self.chrome_driver)
        self.driver.maximize_window()
        self.login_url = rtas_const.login_url

    def run(self):
        # 1、登录
        login(self.driver, self.login_url)

        # 2、搜索wiki
        wiki(self.driver)

• 登录

from com.feng.util import element_util
from com.feng.const import rtas_const

def login(driver,url):
    """
    登录操作
    :param driver:
    :param url:
    """
    # 发送首页
    driver.get(url)

    # 点击登录
    element_util.onclick_element(driver,"//*[@id='app']/div/div/div[1]/div/ul/li/a")

    # 获取当前页面的用户名、密码输入框
    driver.implicitly_wait(2)
    user_name = element_util.get_element(driver,"//*[@id='app']/div/section/div/div/form/div[1]/div/div/input")
    user_password = element_util.get_element(driver,'//*[@id="app"]/div/section/div/div/form/div[2]/div/div/input')

    # 输入用户名、用户密码
    user_name.send_keys(rtas_const.user_name)
    user_password.send_keys(rtas_const.user_password)

    # 点击登录
    element_util.onclick_element(driver,'//*[@id="app"]/div/section/div/div/form/div[3]/div/button')
    driver.implicitly_wait(2)

• wiki

from com.feng.util import element_util
from selenium.webdriver.common.keys import Keys


def wiki(driver):
    """
    操作wiki模块
    :param driver:
    :param xpath:
    """
    # 进入wiki模块
    element_util.onclick_element(driver,'//*[@id="item-list"]/li[4]/a')
    driver.implicitly_wait(2)

    # 获取搜索框
    search_input = element_util.get_element(driver,'//*[@id="left-side"]/div/ul/div[1]/input')

    # 输入搜索内容
    search_input.send_keys("服")

    # 按回车键
    search_input.send_keys(Keys.ENTER)

• github
  https://github.com/fengsri/python-selenium.git

【五】链接

• https://selenium.dev/selenium/docs/api/py/api.html
• https://www.cnblogs.com/feng0815/p/8334144.html