browser
index
e:\uninersdk\src\uniner\web\browser.py

 
Modules
       
json
os
platform
psutil
requests
sys
time

 
Classes
       
builtins.object
chrome

 
class chrome(builtins.object)
    chrome(playwright)
 
# import eventlet
# import tkinter  # python 3 syntax
#浏览器操作
 
  Methods defined here:
__init__(self, playwright)
Initialize self.  See help(type(self)) for accurate signature.
check(self, xpath, time_pre=0, time_pro=0, isload=None, ischeck=1, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param ischeck: 状态:1-选中,0-取消
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
click(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=3000, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
close_browser(self, time_pre=0, time_pro=0)
# 关闭浏览器
close_page(self, flg='', pages='', timeout=0, exc=0)
# 关闭网页
dblclick(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: str类型元素xpath
:param time_pre: int类型,运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待网路加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
dialog(self, option=None, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
@param option: True则确定,False则取消,None则无点击按钮
@return:
download(self, xpath, path, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, duplicate=1, retry_n=0, retry_time=0)
:param xpath: 下载按钮的xpath
:param path: 文件报错路径
:param time_pre: 执行前等待
:param time_pro: 执行后等待
:param isload: 是否等待网络加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param duplicate: 重复文件:0-抛出异常,1-覆盖
    :param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
drag_and_drop(self, xpath, x=10, y=0, type=0, time_pre=0, time_pro=0, isload=None, timeout=1, exc=0, retry_n=0, retry_time=0)
:param xpath:str,元素xpath
:param x:float,水平移动距离
:param y:float,垂直移动距离
:param type:int,拖拽速度,0-快,1-慢,2-拟人
:param time_pre:运行前延时
:param isload:是否加载完成
:param time_pro:运行后延时
:param timeout: 超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
element_screenshot(self, xpath, picpath, time_pre=0, time_pro=0, isload=None, timeout=1, exc=0, retry_n=0, retry_time=0)
:param xpath:元素xpath
:param picpath:图片保存地址
:param time_pre:运行前延时
:param isload:是否加载完成
:param time_pro:运行后延时
:param timeout: 超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
execute_js(self, type, filepath, js_code, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
:param type: 输入方式if:0-js代码,1-文件
:param filepath: 文件地址
:param js_code: js代码
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 加载完成
:param timeout: 超时时间
:param exc: 异常处理
:return:
fill(self, xpath, val, time_pre=0, time_pro=0, isload=None, focus=1, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param val: 填充的值
:param time_pre:运行前延时
:param time_pro:运行后延时
:param isload:是否加载完成
:param focus:是否让焦点消失:0-消失,1-不消失
:param timeout:超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
get_attribute(self, xpath, attr, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath:元素xpath
:param attr:获取的属性名
:param time_pre:运行前延时
:param time_pro:运行后延时
:param isload:是否加载完成
:param timeout:超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
get_bounding_box(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=1, exc=0, retry_n=0, retry_time=0)
:param xpath:元素xpath
:param time_pre:运行前延时
:param isload:是否加载完成
:param time_pro:运行后延时
:param timeout: 超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:dict,{x: float, y: float, width: float, height: float}
get_cookie(self, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
# 读取cookie
get_elment(self)
#获取操作对象
get_frame(self, page, xpath)
#获取iframe
get_innerHTML(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
get_innertext(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
get_outerHTML(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=10, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
get_page(self, type, val, exc)
:param type: int类型:0-根据标题匹配、1-根据网址匹配、2-匹配当前活动页
:param val:string类型,网址或者标题
:param exc: 异常处理 int类型:0-抛出异常,1-忽略继续
:return: 网页对象
get_table(self, xpath, nextpage_xpath, page_num=1, time_pre=0, time_pro=0, isload=None, exc=0, retry_n=0, retry_time=0, next_time=1)
:param xpath: 表格xoath
:param nextpage_xpath:下一页xpath
:param page_num:页数,int类型
:param time_pre: 执行前等待
:param time_pro: 执行后等待
:param isload: 是否等待网络加载完成
:param exc: 异常处理
    :param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
get_text(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
get_text_all(self, xpath, attr, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 相似元素的xpath
:param attr: 属性:默认是text,可以是元素的任意属性
:param time_pre: 执行前延时
:param time_pro: 执行后延时
:param isload: 是否等待网络加载完成
:param exc: 异常处理
    :param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:所有相似元素的text或者属性值,list类型
get_xpath(self, xpath)
#获取xpath
get_xpath_list(self, xpath_list)
#多组xpath获取iframe,返回可用xpath
go_back(self, time_pre=0, time_pro=0, isload=None)
# 后退
go_forward(self, time_pre=0, time_pro=0, isload=None)
# 前进
goto_url(self, page_arg, url, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
:param page_arg: 起始跳转页
:param url: 目标网址
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待网络加载完成
:param timeout: 超时时间
:param exc: 出错后是否抛异常
:return:
hover(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param timeout: 超时时间
:param exc:异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
html(self, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
:param time_pre:运行前延时
:param time_pro:运行后延时
:param isload:是否加载完成
:param timeout:超时时间
:param exc:异常处理
:return:
is_contain(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待网络加载完成
:param timeout: 超时时间
:param exc: 异常处理
:return:
is_ture_checked(self, xpath, time_pre=0, time_pro=0, timeout=3000, isload=None, exc=0)
:param xpath: 元素xpath
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param timeout: 超时时间
:param isload: 是否加载完成
:param exc: 异常处理
:return:
mouse_down(self, button='left', time_pre=0, time_pro=0, exc=0)
:param button: str,按钮"left", "middle", "right"
:param time_pre: int,运行前延时
:param time_pro: int,运行后延时
:param exc: int,异常处理,0抛出异常,1跳过
:return:
mouse_move(self, ix=0, iy=0, time_pre=0, time_pro=0, exc=0)
:param ix: int,x坐标
:param iy: int,y坐标
:param time_pre: int,运行前延时
:param time_pro: int,运行后延时
:param exc: int,异常处理,0抛出异常,1跳过
:return:
mouse_up(self, time_pre=0, time_pro=0, exc=0)
:param time_pre: int,运行前延时
:param time_pro: int,运行后延时
:param exc: int,异常处理,0抛出异常,1跳过
:return:
open_browser(self, parameters='')
#打开浏览器
open_page(self, url='', time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, is_download=0, parameters='')
@param url: 网址
@return: 一个page对象
press(self, xpath, key, time_pre=0, time_pro=0, isload=None, delay=0, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素的xpath
:param key: 键盘键值
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待加载完成
:param delay: 输入间隔
:param timeout: 超时
:param exc: 异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
refresh(self, time_pre=0, time_pro=0, isload=None)
# 刷新
rightclick(self, xpath, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: str类型元素xpath
:param time_pre: int类型,运行前延时
:param time_pro: int类型,运行后延时
:param isload:布尔值,是否等待网路加载完成
:param timeout:int,超时时间
:param exc:int,异常处理
:param retry_n:int类型,重试次数
:param retry_time:浮点类型,重试等待时间
:return:
screenshot(self, file_name, full_page=False, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
:param full_page: 是否截取整个页面
:param file_name:截图名称
:return:
select_option(self, xpath, value, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param value: 下拉选项
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
set_cookie(self, cookie, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
@param cookie:
@return:
set_input_files(self, xpath, files, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param files: 上传文件的地址
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否等待加载完成
:param timeout: 等待元素出现时间(超时时间)
:param exc: 异常处理
:param retry_n: int类型,重试次数
:param retry_time: 浮点类型,重试等待时间
:return:
switch_frame(self, xpath, time_pre=0, time_pro=0, isload=None)
# 切换iframe
switch_page(self, arg, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
@param arg: int或者page对象,int:打开的所有page都会存放到数组,可以传数组的下标获取page
@return:
title(self, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
# 网页标题
transform_path(self, file_path)
type(self, xpath, val, time_pre=0, time_pro=0, isload=None, delay=0, focus=1, timeout=1, exc=0, retry_n=0, retry_time=0)
:param xpath: 元素xpath
:param val: 输入的内容
:param time_pre: 运行前延时
:param time_pro: 运行后延时
:param isload: 是否加载完成
:param delay: 输入间隔时间
:param timeout: 超时时间
:param exc: 异常处理
:param retry_n: int类型,重试次数
    :param retry_time: 浮点类型,重试等待时间
:return:
url(self, time_pre=0, time_pro=0, isload=None, timeout=0, exc=0)
# 网页url
wait(self, seconds=1, timeout=1, exc=0)
:param seconds: 等待时间
:param timeout: 超时时间
:param exc: 异常处理
:return:
wait_element(self, xpath, time_pre=0, time_pro=0, isload=None)
#等待元素

Data descriptors defined here:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
Functions
       
sleep(...)
sleep(seconds)
 
Delay execution for a given number of seconds.  The argument may be
a floating point number for subsecond precision.