Pyse( selenium-api的二次封装)

2018/07/16 16:23
阅读数 88

 pyse seleniumapi的二次封装

 

from selenium import webdriver

from selenium.webdriver.common.action_chains import ActionChains

from selenium.webdriver.support import expected_conditions as EC ####获取 元素等待需要导入的包

from selenium.webdriver.support.ui import WebDriverWait ####获取 元素等待需要导入的包

from selenium.webdriver.common.by import By ####获取 元素等待需要导入的包

from selenium.webdriver.support.select import Select

 

 

class Pyse(object):   ###不需要继承父类

    '''

        Pyse framework for the main class, the original

    selenium provided by the method of the two packaging,

    making it easier to use.

    '''

 

    def __init__(self, browser='ff'):    ### 需要实例化参数

        '''

        Run class initialization method, the default is proper

        to drive the Firefox browser. Of course, you can also

        pass parameter for other browser, Chrome browser for the "Chrome",

        the Internet Explorer browser for "internet explorer" or "ie".

        '''

        if browser == "firefox" or browser == "ff":

            driver = webdriver.Firefox()

        elif browser == "chrome":

            option = webdriver.ChromeOptions()   ###这是chrom提供的几个配置文件

            option.add_argument("--start-maximized")  ##增加配置文件,这里指启动时直接全屏

            driver = webdriver.Chrome(chrome_options=option)  ##实例化时直接传进来即可

        elif browser == "internet explorer" or browser == "ie":

            driver = webdriver.Ie()

        elif browser == "opera":

            driver = webdriver.Opera()

        elif browser == "phantomjs":

            driver = webdriver.PhantomJS()

        elif browser == 'edge':

            driver = webdriver.Edge()

        try:

            self.driver = driver

        except Exception:

            raise NameError(

                "Not found %s browser,You can enter 'ie', 'ff', 'opera', 'phantomjs', 'edge' or 'chrome'." % browser)

 

    def element_wait(self, css, secs=5):

        '''

        Waiting for an element to display.

 

        Usage:

        driver.element_wait("css=>#el",10)

        '''

        if "=>" not in css:

            raise NameError("Positioning syntax errors, lack of '=>'.")

 

        by = css.split("=>")[0]

        value = css.split("=>")[1]

 

        if by == "id":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.ID, value)))  ##参数是一个元组

        elif by == "name":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.NAME, value)))

        elif by == "class":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.CLASS_NAME, value)))

        elif by == "link_text":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.LINK_TEXT, value)))

        elif by == "xpath":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.XPATH, value)))

        elif by == "css":

            WebDriverWait(self.driver, secs, 1).until(EC.presence_of_element_located((By.CSS_SELECTOR, value)))

        else:

            raise NameError(

                "Please enter the correct targeting elements,'id','name','class','link_text','xpath','css'.")

 

    def get_element(self, css):   ##获取定位元素

        '''

        Judge element positioning way, and returns the element.

        '''

        if "=>" not in css:

            raise NameError("Positioning syntax errors, lack of '=>'.")

 

        by = css.split("=>")[0]

        value = css.split("=>")[1]

 

        if by == "id":

            element = self.driver.find_element_by_id(value)

        elif by == "name":

            element = self.driver.find_element_by_name(value)

        elif by == "class":

            element = self.driver.find_element_by_class_name(value)

        elif by == "link_text":

            element = self.driver.find_element_by_link_text(value)

        elif by == "xpath":

            element = self.driver.find_element_by_xpath(value)

        elif by == "css":

            element = self.driver.find_element_by_css_selector(value)   ####通过css方式定位

        else:

            raise NameError(

                "Please enter the correct targeting elements,'id','name','class','link_text','xpath','css'.")

        return element     ###注意这里需要返回元素的值。

 

    def open(self, url):

        '''

        open url.

 

        Usage:

        driver.open("https://www.baidu.com")

        '''

        self.driver.get(url)    ####只是一个方法是一个函数。源码是post

 

    def max_window(self):

        '''

        Set browser window maximized.

 

        Usage:

        driver.max_window()

        '''

        self.driver.maximize_window()

 

    def set_window(self, wide, high):

        '''

        Set browser window wide and high.

 

        Usage:

        driver.set_window(wide,high)

        '''

        self.driver.set_window_size(wide, high)

 

    def type(self, css, text):

        '''

        Operation input box.

 

        Usage:

        driver.type("css=>#el","selenium")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        el.send_keys(text)

 

    def clear(self, css):

        '''

        Clear the contents of the input box.

 

        Usage:

        driver.clear("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        el.clear()

 

    def click(self, css):

        '''

        It can click any text / image can be clicked

        Connection, check box, radio buttons, and even drop-down box etc..

 

        Usage:

        driver.click("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        el.click()

 

    def right_click(self, css):

        '''

        Right click element.

 

        Usage:

        driver.right_click("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        ActionChains(self.driver).context_click(el).perform()

 

    def move_to_element(self, css):

        '''

        Mouse over the element.

 

        Usage:

        driver.move_to_element("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        ActionChains(self.driver).move_to_element(el).perform()

 

    def double_click(self, css):

        '''

        Double click element.

 

        Usage:

        driver.double_click("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        ActionChains(self.driver).double_click(el).perform()

 

    def drag_and_drop(self, el_css, ta_css):

        '''

        Drags an element a certain distance and then drops it.

 

        Usage:

        driver.drag_and_drop("css=>#el","css=>#ta")

        '''

        self.element_wait(el_css)

        element = self.get_element(el_css)

        self.element_wait(ta_css)

        target = self.get_element(ta_css)

        ActionChains(driver).drag_and_drop(element, target).perform()

 

    def click_text(self, text):

        '''

        Click the element by the link text

 

        Usage:

        driver.click_text("新闻")

        '''

        self.driver.find_element_by_partial_link_text(text).click()

 

    def close(self):

        '''

        Simulates the user clicking the "close" button in the titlebar of a popup

        window or tab.

 

        Usage:

        driver.close()

        '''

        self.driver.close()

 

    def quit(self):

        '''

        Quit the driver and close all the windows.

 

        Usage:

        driver.quit()

        '''

        self.driver.quit()

 

    def submit(self, css):

        '''

        Submit the specified form.

 

        Usage:

        driver.submit("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        el.submit()

 

    def F5(self):

        '''

        Refresh the current page.

 

        Usage:

        driver.F5()

        '''

        self.driver.refresh()

 

    def js(self, script):

        '''

        Execute JavaScript scripts.

 

        Usage:

        driver.js("window.scrollTo(200,1000);")

        '''

        self.driver.execute_script(script)

 

    def get_attribute(self, css, attribute):

        '''

        Gets the value of an element attribute.

 

        Usage:

        driver.get_attribute("css=>#el","type")

        '''

        el = self.get_element(css)

        return el.get_attribute(attribute)

 

    def get_text(self, css):

        '''

        Get element text information.

 

        Usage:

        driver.get_text("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        return el.text

 

    def get_display(self, css):

        '''

        Gets the element to display,The return result is true or false.

 

        Usage:

        driver.get_display("css=>#el")

        '''

        self.element_wait(css)

        el = self.get_element(css)

        return el.is_displayed()

 

    def get_title(self):

        '''

        Get window title.

 

        Usage:

        driver.get_title()

        '''

        return self.driver.title

 

    def get_url(self):

        '''

        Get the URL address of the current page.

 

        Usage:

        driver.get_url()

        '''

        return self.driver.current_url

 

    def get_windows_img(self, file_path):

        '''

        Get the current window screenshot.

 

        Usage:

        driver.get_windows_img()

        '''

        self.driver.get_screenshot_as_file(file_path)

 

    def wait(self, secs):

        '''

        Implicitly wait.All elements on the page.

 

        Usage:

        driver.wait(10)

        '''

        self.driver.implicitly_wait(secs)

 

    def accept_alert(self):

        '''

        Accept warning box.

 

        Usage:

        driver.accept_alert()

        '''

        self.driver.switch_to.alert.accept()

 

    def dismiss_alert(self):

        '''

        Dismisses the alert available.

 

        Usage:

        driver.dismiss_alert()

        '''

        self.driver.switch_to.alert.dismiss()

 

    def switch_to_frame(self, css):

        '''

        Switch to the specified frame.

 

        Usage:

        driver.switch_to_frame("css=>#el")

        '''

        self.element_wait(css)

        iframe_el = self.get_element(css)

        self.driver.switch_to.frame(iframe_el)  ###切换 但如果是id name可以直接switch 参入参数即可

 

    def switch_to_frame_out(self):

        '''

        Returns the current form machine form at the next higher level.

        Corresponding relationship with switch_to_frame () method.

 

        Usage:

        driver.switch_to_frame_out()

        '''

        self.driver.switch_to.default_content()

 

    def open_new_window(self, css):

        '''

        Open the new window and switch the handle to the newly opened window.

 

        Usage:

        driver.open_new_window()

        '''

        original_windows = self.driver.current_window_handle

        el = self.get_element(css)

        el.click()

        all_handles = self.driver.window_handles

        for handle in all_handles:

            if handle != original_windows:

                self.driver.switch_to.window(handle)

 

    # def _save_png(self, name):

    #     self.get_windows_img(name)

 

    def wait_and_save_exception(self, css, name): ##等待并且保存错误截图

        try:

            self.element_wait(css, secs=5)

            return True

        except Exception as e:

            from lib.core.path import WEBPICTUREPATH  ###文件地址

            self.get_windows_img(WEBPICTUREPATH + name + '.jpg')

            return False

 

    def wait_and_exception(self, css):

        try:

            self.element_wait(css, secs=10)

            return True

        except Exception as e:

            return False

 

    def select_by_value(self, css, value):

        self.element_wait(css)

        el = self.get_element(css)

        Select(el).select_by_value(value)

 

 

 

if __name__ == '__main__':   ####便于本文件调试使用,只有在当前页面会执行该代码

    driver = Pyse("chrome")

 

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部