python+selenium十：selenium的二次封装

python+selenium十：基于原生selenium的二次封装

 

from selenium import webdriver
from selenium.webdriver.support.wait import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.select import Select
from selenium.webdriver.common.action_chains import ActionChains
from selenium.webdriver.common.by import By
# BY的用法
# driver.find_element("id", "kw")
# driver.find_element(By.ID, "kw")

class Bace():
    '''基于原生的selenium做二次封装'''

    def __init__(self, driver:webdriver.Firefox):  # driver:webdriver.Firefox：映射driver 为webdriver.Firefox
        self.driver = driver
        self.timeout = 10
        self.t = 0.5

    def find(self, locator, value=''):
        '''  定位到元素，返回元素对象，没定位到，Timeout异常 loctor 传元祖，如（"id", "kw"）  '''
        if not isinstance(locator, tuple):
            print('locator参数类型错误，必须传元祖类型：loc = ("id", "value1")')
        else:
            print(f"正在定位元素信息：定位方式->{locator[0]}, 元素值->{locator[1]}，value值->{value}")
            if value != '':  # value值定位
                ele = WebDriverWait(self.driver, self.timeout, self.t).until(EC.text_to_be_present_in_element_value(locator, value))
                return ele
            else:  # 默认为此常规定位方法
                ele = WebDriverWait(self.driver, self.timeout, self.t).until(EC.presence_of_element_located(locator))
                if ele:
                    return ele
                else:
                    print(f"定位失败：定位方式->{locator[0]}, value值->{locator[1]}")
                    return False

    def finds(self, locator, value=''):
        ''' 定位到元素，返回元素对象，没定位到，Timeout异常  loctor 传元祖，如（"id", "kw"）  '''
        if not isinstance(locator, tuple):
            print('locator参数类型错误，必须传元祖类型：loc = ("id", "value1")')
        else:
            print(f"正在定位元素信息：定位方式->{locator[0]}, 元素值->{locator[1]}，value值->{value}")
            if value != '':  # value值定位
                eles = WebDriverWait(self.driver, self.timeout, self.t).until(EC.text_to_be_present_in_element_value(locator, value))
                return eles
            else:  # 默认为此常规定位方法
                eles = WebDriverWait(self.driver, self.timeout, self.t).until(EC.presence_of_element_located(locator))
                if eles:
                    return eles
                else:
                    print(f"定位失败：定位方式->{locator[0]}, value值->{locator[1]}")
                    return []

    def sendKeys(self, locator, text):
        try:
            self.find(locator).send_keys(text)
        except:
            print(f"输入 {text} 失败")

    def click(self, locator):
        try:
            self.find(locator).click()
        except:
            print("点击失败")

    def clear(self, locator):
        try:
            self.find(locator).clear()
        except:
            print("清空内容失败")

    def isSelected(self, locator, Type=''):
        ''' 判断元素是否被选中，返回bool值 及点（选中/取消选中）'''
        ele = self.find(locator)
        try:
            if Type == '':  # 如果type参数为空，返回元素是否为选中状态，True/False (默认)
                r = ele.is_selected()
                return r
            elif Type == 'click':  # 如果type参数为click，执行元素的点击操作
                ele.click()
            else:
                print(f"type参数 {Type} 错误，仅可为click或''")
        except:
            return False

    def isElementExist(self, locator):
        ''' 判断单个元素是否在DOM里面 （是否存在）'''
        try:
            self.find(locator)
            return True
        except:
            return False

    def isElementExists(self, locator):
        ''' 判断一组元素是否在DOM里面 （是否存在），若不存在，返回一个空的list'''
        eles = self.finds(locator)
        n = len(eles)
        if n == 0:
            return False
        elif n == 1:
            return True
        else:
            print(f"定位到元素的个数：{n}")
            return True

    def title(self, title, Type='contains'):
        '''  根据传入的type类型判断title  '''
        try:
            if Type == 'is':  # 判断当前网页title名为title   返回bool值
                result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.title_is(title))
                return result
            elif Type == 'contains':  # 判断当前网页title名含title   返回bool值 (默认)
                result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.title_contains(title))
                return result
            else:
                print(f"type参数 {Type} 错误，仅可为is、contains")
        except:
            return False

    def in_element(self, locator, value, Type='text'):
        '''  根据传入的type判断内容是否在指定元素里面  '''
        if not isinstance(locator, tuple):
            print('locator参数类型错误，必须传元祖类型：loc = ("id", "value1")')
        try:
            if Type == 'text':  # 判断当前获取到的text含value   返回bool值 （默认）
                result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.text_to_be_present_in_element(locator, value))
                return result
            elif Type == 'value':  # 判断当前获取到的value含value 返回bool值, value为空字符串，返回False
                result = self.find(locator, value)
                return result
            else:
                print(f"type参数 {Type} 错误，仅可使用text或value属性定位")
                return False
        except:
            return False

    def alert(self, timeout=3, Type=''):
        ''' 根据传入的type判断alert弹窗及操作 '''
        result = WebDriverWait(self.driver, timeout, self.t).until(EC.alert_is_present())
        try:
            if Type == '':  # 判断alert是否存在，如果有，就返回alert对象 （默认）
                if result:
                    return result
                else:
                    print("alert不存在")
                return False
            elif Type == 'yes':  # 执行alert的确定按钮
                result.accept()
            elif Type == 'no':  # 执行alert的取消按钮
                result.dismiss()
            else:
                print(f"type参数 {Type} 错误，仅可为yes、no、或''")
        except:
            return False

    def get(self, locator, Type='text', name=''):
        ''' 根据传入的type判断获取指定的内容 （title、text、attribute）
        type==attribute:  获取元素属性  name:属性  className、name、text、value···  '''
        try:
            if Type == 'title':  # 获取当前网页 title
                return self.driver.title
            elif Type == 'text':  # 获取元素文本值（默认）
                return self.find(locator).text
            elif Type == 'attribute':  # 获取当前元素属性
                return self.find(locator).get_attribute(name)
            else:
                print(f"给的type参数 {Type} 错误，仅可用title、text、attribute")
        except:
            print(f"获取 {Type} 值失败")
            return ''

    def select(self, locator, value, Type='index'):
        '''  下拉选项框 根据传入的type值判断（index、value、text）  '''
        element = self.find(locator)  # 定位select这一栏
        try:
            if Type == 'index':  # 用下标选择 （默认）
                Select(element).select_by_index(value)
            elif Type == 'value':  # 根据value值选择
                Select(element).select_by_value(value)
            elif Type == 'text':  # 根据选项的文本内容选择
                Select(element).select_by_visible_text(value)
            else:
                print(f"给的type参数 {Type} 错误，仅可为：int、text、value")
        except:
            print(f"根据 {value} 操作下拉框失败")

    def iframe(self, id_index_locator):
        ''' 常规切换 iframe'''
        try:
            if isinstance(id_index_locator, int):  # 如果传入的是数字，则以该数字为下标取值
                self.driver.switch_to.frame(id_index_locator)
            elif isinstance(id_index_locator, str):  # 如果传入的是字符串，则用iframe名字取值
                self.driver.switch_to.frame(id_index_locator)
            elif isinstance(id_index_locator, tuple):  # 如果是元祖，则根据传入的locator取值
                ele = self.find(id_index_locator)
                self.driver.switch_to.frame(ele)
        except:
             print("iframe切换异常")

    def handle(self, value):
        ''' 句柄切换，index、句柄名 '''
        try:
            if isinstance(value, int):  # 切换到该下标对应的窗口
                handles = driver.window_handles
                self.driver.switch_to.window(handles[value])
            elif isinstance(value, str):  # 切换到该句柄名称对应的窗口
                self.driver.switch_to.window(value)
            else:
                print(f"传入的type参数 {value} 错误，仅可传int、str")
        except:
            print(f"根据 {value} 获取句柄失败")

    def move_to_element(self, locator):
        ''' 鼠标悬停操作 '''
        try:
            ele = self.find(locator)
            ActionChains(self.driver).move_to_element(ele).perform()
        except:
            print("鼠标悬停操作失败")
            return False
    '''==============================js与jQuery相关====================================='''

    def js_focus_element(self, locator):
        ''' 聚焦元素 '''
        target = self.find(locator)
        self.driver.execute_script("arguments[0].scrollIntoView();", target)

    def js_scroll_top(self):
        ''' 滚动到顶部 '''
        js = "window.scrollTo(0,0)"
        self.driver.execute_script(js)

    def js_scroll_end(self, x=0):
        ''' 滚动到底部 '''
        js = f"window.scrollTo({x},document.body.scrollHeight)"
        self.driver.execute_script(js)

    def js_find(self, action):
        '''  js查找元素，并做相应操作（默认id属性） 输入值：value='XXX'  点击：click() '''
        js = f"document.getElementById(“id”).{action}"
        self.driver.execute_script(js)

    def js_finds(self, Type, element, index, action):
        '''   js查找元素，并做相应操作   输入值：value='XXX'     点击：click()
        js定位仅可为：id、Name、TagName、ClassName、Selector（CSS） '''
        list = ['Name', 'TagName', 'ClassName', 'Selector']
        if type in list:
            print(f"正在执行js操作：定位方式->{Type}, 元素值->{element}， 下标值->{index}， 执行操作->{action}")
            if type == 'Selector':
                js = f'document.query{Type}All("{element}"){index}.{action}'
            else:
                js = f'document.getElementsBy{Type}({element})[{index}].{action};'
            self.driver.execute_script(js)
        else:
            print(f"type参数 {Type} 错误，js定位仅可为：'Name'、'TagName'、'ClassName'、'Selector'（CSS）")

    def js_readonly(self, idElement, value):
        ''' 去掉只读属性，并输入内容 一般为id '''
        js = f'document.getElementById({idElement}).removeAttribute("readonly");document.getElementById({idElement}).value="{value}"'
        driver.execute_script(js)

    def js_iframe(self, Type, element, action, index=''):
        '''  Js处理iframe   无需先切换到iframe上，再切回来操作
        输入值：value=''         点击：click()           type=id时，index=''  '''
        js = f'document.getElementBy{Type}({element}){index}.contentWindow.document.body.{action}'
        driver.execute_script(js)
    '''
        jquery = '$(CSS).val("XXX");'   # 根据css语法定位到元素，输入内容
        jquery = '$(CSS).val('');'      # 清空
        jquery = '$(CSS).click();'      # 点击
        driver.execute_script(jquery)
    '''

    # def switch_alert(self):
    #     ''' 获取alert弹窗 '''
    #     r = self.is_alert()
    #     if not r:
    #         print("alert不存在")
    #     else:
    #         return r

    # def is_title(self, title):
    #     '''判断当前title名为title   返回bool值'''
    #     try:
    #         result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.title_is(title))
    #         return result
    #     except:
    #         return False
    # def is_title_contains(self, title):
    #     '''判断当前title名含title   返回bool值'''
    #     try:
    #         result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.title_contains(title))
    #         return result
    #     except:
    #         return False

    # def is_text_in_element(self, locator, _text=''):
    #     '''判断当前获取到的text含_text=''   返回bool值'''
    #     if not isinstance(locator, tuple):
    #         print('locator参数类型错误，必须传元祖类型：loc = ("id", "value1")')
    #     try:
    #         result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.text_to_be_present_in_element(locator, _text))
    #         return result
    #     except:
    #         return False
    # def is_value_in_element(self, locator, _value=''):
    #     '''返回bool值, value为空字符串，返回False'''
    #     if not isinstance(locator, tuple):
    #         print('locator参数类型错误，必须传元祖类型：loc = ("id", "value1")')
    #     try:
    #         result = WebDriverWait(self.driver, self.timeout, self.t).until(EC.text_to_be_present_in_element_value(locator, _value))
    #         return result
    #     except:
    #         return False

    # def get_title(self):
    #     '''获取title'''
    #     return self.driver.title
    # def get_text(self, locator):
    #     '''获取文本'''
    #     try:
    #         t = self.find(locator).text
    #         return t
    #     except:
    #         print("获取text失败，返回'' ")
    #         return ""
    # def get_attribute(self, locator, name):
    #     '''获取属性'''
    #     try:
    #         element = self.find(locator)
    #         return element.get_attribute(name)
    #     except:
    #         print("获取%s属性失败，返回'' "%name)
    #         return ""

    # def select_by_index(self, locator, index=0):
    #     '''通过索引,index是索引第几个，从0开始，默认选第一个'''
    #         element = self.find(locator)  # 定位select这一栏
    #         Select(element).select_by_index(index)

    # def select_by_value(self, locator, value):
    #     '''通过value属性'''
    #     element = self.find(locator)
    #     Select(element).select_by_value(value)

    # def select_by_text(self, locator, text):
    #     '''通过文本值定位'''
    #     element = self.find(locator)
    #     Select(element).select_by_visible_text(text)

    # def switch_handle_window_name(self, window_name):
    #     ''' 根据句柄名字切换句柄 '''
    #     self.driver.switch_to.window(window_name)
    # def switch_handle_index(self, index):
    #     '''  根据句柄下标切换句柄  '''
    #     handles = driver.window_handles
    #     self.driver.switch_to.window(handles[index])

    # def js_find(self, action):
    #     '''
    #     输入值：value='XXX'     点击：click()
    #     '''
    #     print("正在执行js操作，操作行为：%s"%action)
    #     js = "document.getElementById(“id”).%s"%action
    #     self.driver.execute_script(js)

if __name__ == "__main__":
    driver = webdriver.Firefox()
    driver.get("")
    zentao = Base(driver)
    # loc1 = (By.ID, "account")
    # loc2 = (By.CSS_SELECTOR, "[name='password']")
    # loc3 = (By.XPATH, "//*[@id='submit']")

    loc1 = ("id", "account")
    loc2 = ("css selector", "[name='password']")
    loc3 = ("xpath", "//*[@id='submit']")
    zentao.sendKeys(loc2, 123)

    zentao.move_to_element(loc3)