tdrpa.tdworker 1.2.13.2__py312-none-win_amd64.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- tdrpa/_tdxlwings/__init__.py +193 -0
- tdrpa/_tdxlwings/__pycache__/__init__.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/__init__.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/_win32patch.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/_win32patch.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/_xlwindows.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/_xlwindows.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/apps.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/apps.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/base_classes.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/base_classes.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/com_server.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/com_server.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/constants.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/constants.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/expansion.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/expansion.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/main.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/main.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/udfs.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/udfs.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/utils.cpython-311.pyc +0 -0
- tdrpa/_tdxlwings/__pycache__/utils.cpython-38.pyc +0 -0
- tdrpa/_tdxlwings/_win32patch.py +90 -0
- tdrpa/_tdxlwings/_xlmac.py +2240 -0
- tdrpa/_tdxlwings/_xlwindows.py +2518 -0
- tdrpa/_tdxlwings/addin/Dictionary.cls +474 -0
- tdrpa/_tdxlwings/addin/IWebAuthenticator.cls +71 -0
- tdrpa/_tdxlwings/addin/WebClient.cls +772 -0
- tdrpa/_tdxlwings/addin/WebHelpers.bas +3203 -0
- tdrpa/_tdxlwings/addin/WebRequest.cls +875 -0
- tdrpa/_tdxlwings/addin/WebResponse.cls +453 -0
- tdrpa/_tdxlwings/addin/xlwings.xlam +0 -0
- tdrpa/_tdxlwings/apps.py +35 -0
- tdrpa/_tdxlwings/base_classes.py +1092 -0
- tdrpa/_tdxlwings/cli.py +1306 -0
- tdrpa/_tdxlwings/com_server.py +385 -0
- tdrpa/_tdxlwings/constants.py +3080 -0
- tdrpa/_tdxlwings/conversion/__init__.py +103 -0
- tdrpa/_tdxlwings/conversion/framework.py +147 -0
- tdrpa/_tdxlwings/conversion/numpy_conv.py +34 -0
- tdrpa/_tdxlwings/conversion/pandas_conv.py +184 -0
- tdrpa/_tdxlwings/conversion/standard.py +321 -0
- tdrpa/_tdxlwings/expansion.py +83 -0
- tdrpa/_tdxlwings/ext/__init__.py +3 -0
- tdrpa/_tdxlwings/ext/sql.py +73 -0
- tdrpa/_tdxlwings/html/xlwings-alert.html +71 -0
- tdrpa/_tdxlwings/js/xlwings.js +577 -0
- tdrpa/_tdxlwings/js/xlwings.ts +729 -0
- tdrpa/_tdxlwings/mac_dict.py +6399 -0
- tdrpa/_tdxlwings/main.py +5205 -0
- tdrpa/_tdxlwings/mistune/__init__.py +63 -0
- tdrpa/_tdxlwings/mistune/block_parser.py +366 -0
- tdrpa/_tdxlwings/mistune/inline_parser.py +216 -0
- tdrpa/_tdxlwings/mistune/markdown.py +84 -0
- tdrpa/_tdxlwings/mistune/renderers.py +220 -0
- tdrpa/_tdxlwings/mistune/scanner.py +121 -0
- tdrpa/_tdxlwings/mistune/util.py +41 -0
- tdrpa/_tdxlwings/pro/__init__.py +40 -0
- tdrpa/_tdxlwings/pro/_xlcalamine.py +536 -0
- tdrpa/_tdxlwings/pro/_xlofficejs.py +146 -0
- tdrpa/_tdxlwings/pro/_xlremote.py +1293 -0
- tdrpa/_tdxlwings/pro/custom_functions_code.js +150 -0
- tdrpa/_tdxlwings/pro/embedded_code.py +60 -0
- tdrpa/_tdxlwings/pro/udfs_officejs.py +549 -0
- tdrpa/_tdxlwings/pro/utils.py +199 -0
- tdrpa/_tdxlwings/quickstart.xlsm +0 -0
- tdrpa/_tdxlwings/quickstart_addin.xlam +0 -0
- tdrpa/_tdxlwings/quickstart_addin_ribbon.xlam +0 -0
- tdrpa/_tdxlwings/quickstart_fastapi/main.py +47 -0
- tdrpa/_tdxlwings/quickstart_fastapi/requirements.txt +3 -0
- tdrpa/_tdxlwings/quickstart_standalone.xlsm +0 -0
- tdrpa/_tdxlwings/reports.py +12 -0
- tdrpa/_tdxlwings/rest/__init__.py +1 -0
- tdrpa/_tdxlwings/rest/api.py +368 -0
- tdrpa/_tdxlwings/rest/serializers.py +103 -0
- tdrpa/_tdxlwings/server.py +14 -0
- tdrpa/_tdxlwings/udfs.py +775 -0
- tdrpa/_tdxlwings/utils.py +777 -0
- tdrpa/_tdxlwings/xlwings-0.31.6.applescript +30 -0
- tdrpa/_tdxlwings/xlwings.bas +2061 -0
- tdrpa/_tdxlwings/xlwings_custom_addin.bas +2042 -0
- tdrpa/_tdxlwings/xlwingslib.cp38-win_amd64.pyd +0 -0
- tdrpa/tdworker/__init__.pyi +12 -0
- tdrpa/tdworker/_clip.pyi +50 -0
- tdrpa/tdworker/_excel.pyi +743 -0
- tdrpa/tdworker/_file.pyi +77 -0
- tdrpa/tdworker/_img.pyi +226 -0
- tdrpa/tdworker/_network.pyi +94 -0
- tdrpa/tdworker/_os.pyi +47 -0
- tdrpa/tdworker/_sp.pyi +21 -0
- tdrpa/tdworker/_w.pyi +129 -0
- tdrpa/tdworker/_web.pyi +995 -0
- tdrpa/tdworker/_winE.pyi +228 -0
- tdrpa/tdworker/_winK.pyi +74 -0
- tdrpa/tdworker/_winM.pyi +117 -0
- tdrpa/tdworker.cp312-win_amd64.pyd +0 -0
- tdrpa_tdworker-1.2.13.2.dist-info/METADATA +38 -0
- tdrpa_tdworker-1.2.13.2.dist-info/RECORD +101 -0
- tdrpa_tdworker-1.2.13.2.dist-info/WHEEL +5 -0
- tdrpa_tdworker-1.2.13.2.dist-info/top_level.txt +1 -0
tdrpa/tdworker/_web.pyi
ADDED
@@ -0,0 +1,995 @@
|
|
1
|
+
from _typeshed import Incomplete
|
2
|
+
from playwright.sync_api import ElementHandle, Page as Page
|
3
|
+
|
4
|
+
class Web:
|
5
|
+
@staticmethod
|
6
|
+
def Click(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, button: str = 'left', clickType: str = 'click', delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True, checkElementShow: bool = True, cursorPosition: str = 'center', cursorOffsetX: int = 0, cursorOffsetY: int = 0, keyModifiers: list = None, simulateType: str = 'simulate', moveSmoothly: bool = False) -> str | None:
|
7
|
+
'''
|
8
|
+
点击元素
|
9
|
+
|
10
|
+
tdrpa_element_id = Web.Click(target, onlyvis=False, index=None, fromElementTdid=None, button="left", clickType="click", delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, checkElementShow=True, cursorPosition=\'center\', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, simulateType=\'simulate\', moveSmoothly=False)
|
11
|
+
|
12
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
13
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
14
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
15
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
16
|
+
:param button: [可选参数]鼠标点击。鼠标左键:"left" 鼠标右键:"right" 鼠标中键:"middle"。默认"left"
|
17
|
+
:param clickType: [可选参数]点击类型。单击:"click" 双击:"dblclick" 按下:"down" 弹起:"up"。默认"click"
|
18
|
+
:param delayTime: [可选参数]超时时间(毫秒)。默认10000
|
19
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
20
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
21
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
22
|
+
:param setForeground: [可选参数]激活窗口。默认True
|
23
|
+
:param checkElementShow: [可选参数]检查元素是否可见。默认True
|
24
|
+
:param cursorPosition: [可选参数]光标位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
|
25
|
+
:param cursorOffsetX: [可选参数]横坐标偏移。默认0
|
26
|
+
:param cursorOffsetY: [可选参数]纵坐标偏移。默认0
|
27
|
+
:param keyModifiers: [可选参数]辅助按键["Alt","Ctrl","Shift","Win"]可多选。默认None
|
28
|
+
:param simulateType: [可选参数]操作类型。模拟操作:"simulate" 接口操作:"api"。默认"simulate"
|
29
|
+
:param moveSmoothly: [可选参数]是否平滑移动鼠标(simulateType为api时会忽略此参数)。默认False
|
30
|
+
:return: tdrpa_element_id
|
31
|
+
'''
|
32
|
+
@staticmethod
|
33
|
+
def CloseBrowser(tryClose: int = 3, userData: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
34
|
+
"""
|
35
|
+
关闭浏览器
|
36
|
+
|
37
|
+
Web.CloseBrowser(tryClose=3, userData=None, continueOnError=False, delayAfter=100, delayBefore=100)
|
38
|
+
|
39
|
+
:param tryClose:[可选参数]尝试关闭浏览器的次数。默认值为 3。如果在指定次数内无法成功关闭浏览器,则会抛出异常。
|
40
|
+
:param userData:[可选参数]用户数据目录的路径。如果未提供,则使用默认路径。
|
41
|
+
:param continueOnError:[可选参数]是否在发生错误时继续执行。默认值为 False。
|
42
|
+
:param delayAfter:[可选参数]延迟关闭浏览器的时间(毫秒)。默认值为 100。
|
43
|
+
:param delayBefore:[可选参数]延迟关闭浏览器之前的时间(毫秒)。默认值为 100。
|
44
|
+
:return: None
|
45
|
+
"""
|
46
|
+
@staticmethod
|
47
|
+
def CloseTab(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
48
|
+
"""
|
49
|
+
关闭当前标签页
|
50
|
+
|
51
|
+
closeResult = Web.CloseTab(continueOnError=False, delayAfter=100, delayBefore=100)
|
52
|
+
|
53
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
54
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
55
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
56
|
+
:return: 关闭成功返回True,失败返回False。只有一个标签页时不能关闭,会返回False
|
57
|
+
"""
|
58
|
+
@staticmethod
|
59
|
+
def CreateBrowser(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportMode: str = 'web', userData: str = None, clearChrome: bool = True, otherStartupParam: Incomplete | None = None, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, debugPort: int = 9222) -> None:
|
60
|
+
"""
|
61
|
+
创建浏览器
|
62
|
+
|
63
|
+
Web.CreateBrowser(url='https://www.baidu.com', chromeExePath=None, isMaximize=True, supportMode='web', userData=None, clearChrome=True, otherStartupParam=None, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100, debugPort=9222)
|
64
|
+
|
65
|
+
:param url:[可选参数]启动浏览器后打开的链接,字符串类型。默认None
|
66
|
+
:param chromeExePath:[可选参数]谷歌浏览器可执行程序的绝对路径,字符串类型,填写None时会自动寻找本地安装的路径。默认None
|
67
|
+
:param isMaximize:[可选参数]浏览器启动后是否最大化显示,选择True时最大化启动,选择False默认状态。默认True
|
68
|
+
:param supportMode:[可选参数]浏览器元素拾取模式,'web': 网页模式, 'uia': 客户端模式,'pw': playwright模式(beta)。默认'web'
|
69
|
+
:param userData:[可选参数]浏览器用户数据存放路径,字符串类型。默认None
|
70
|
+
:param clearChrome:[可选参数]是否在打开新浏览器之前关闭所有现有 Chrome 进程。默认值为 True。
|
71
|
+
:param otherStartupParam:[可选参数]其他启动谷歌浏览器的参数,如:['--xxx', '--xxx']。默认None
|
72
|
+
:param waitPage:[可选参数]是否等待页面加载完成。默认True
|
73
|
+
:param delayTime: 超时时间(毫秒)。默认60000
|
74
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
75
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
76
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
77
|
+
:param debugPort:[可选参数]调试端口。默认9222
|
78
|
+
:return:None
|
79
|
+
"""
|
80
|
+
@staticmethod
|
81
|
+
def CreateTab(url: str = None, tabActive: bool = True, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> int | None:
|
82
|
+
'''
|
83
|
+
新建标签页
|
84
|
+
|
85
|
+
urlResult = Web.CreateTab(url="https://www.baidu.com", tabActive=True, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
86
|
+
|
87
|
+
:param url:[可选参数]要加载的 URL(注意:url需要保留 "https://" 或 "http://" )。如果为 None,加载默认页面。
|
88
|
+
:param tabActive:[可选参数]是否激活新标签页。默认值为 True。
|
89
|
+
:param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
|
90
|
+
:param delayTime: [可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
|
91
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
92
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
93
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
94
|
+
:return:url是None时,返回None,url有具体链接时,返回True或False,代表是否打开了目标链接
|
95
|
+
'''
|
96
|
+
@staticmethod
|
97
|
+
def Exists(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, returnType: str = 'id', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | str | None:
|
98
|
+
'''
|
99
|
+
元素是否存在
|
100
|
+
|
101
|
+
tdrpa_element_id = Web.Exists(target, onlyvis=False, index=None, fromElementTdid=None, returnType=\'id\', continueOnError=False, delayAfter=100, delayBefore=100)
|
102
|
+
|
103
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
104
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
105
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
106
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
107
|
+
:param returnType:[可选参数]返回值的类型。设为\'bool\'时:网页元素存在,结果返回True,否则返回False,设为\'id\'时:网页元素存在,返回tdrpa_element_id,否则返回None.默认id
|
108
|
+
:param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
|
109
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
|
110
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
|
111
|
+
:return:元素存在返回tdrpa_element_id或True,不存在返回None或False(返回类型根据returnType字段设置值而定)。
|
112
|
+
'''
|
113
|
+
@staticmethod
|
114
|
+
def GetAllElements(target: str | dict, onlyvis: bool = False, getMode: str = None, cssTargetFaster: bool = False, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
|
115
|
+
'''
|
116
|
+
获取指定特征所有元素(tdrpa_element_id列表或指定模式的值列表)
|
117
|
+
|
118
|
+
tdrpa_elements = Web.GetAllElements(target, onlyvis=False, getMode=None, cssTargetFaster=False, continueOnError=False, delayAfter=100, delayBefore=100)
|
119
|
+
|
120
|
+
:param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
121
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
122
|
+
:param getMode: [可选参数]获取值的模式。\'autoText\':自动获取文本内容(可能是text、innerText、value其一),\'text\':获取元素内所有文本内容,\'innerText\':获取元素内可见文本内容,\'value\':获取元素值。其他字符视为元素属性值,例如:\'href\'、\'class\'等等。None:获取tdrpa_element_id。默认None
|
123
|
+
:param cssTargetFaster: [可选参数]是否使用css选择器更快的方式获取目标元素。默认False
|
124
|
+
:param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
|
125
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
|
126
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
|
127
|
+
:return:所有目标元素的tdrpa_element_id列表 或 指定模式的值列表。
|
128
|
+
'''
|
129
|
+
@staticmethod
|
130
|
+
def GetAttribute(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, attrname: str | list | None = 'class', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None | dict:
|
131
|
+
'''
|
132
|
+
获取网页元素属性值
|
133
|
+
|
134
|
+
attrValue = Web.GetAttribute(target, onlyvis=False, index=None, fromElementTdid=None, attrname=\'class\', continueOnError=False, delayAfter=100, delayBefore=100)
|
135
|
+
|
136
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
137
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
138
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
139
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
140
|
+
:param attrname: [可选参数]属性名。str类型时:指定单个属性值,list类型时:指定多个属性名,None时:所有属性名。默认\'class\'
|
141
|
+
:param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
|
142
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
|
143
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
|
144
|
+
:return:属性值字符串或属性键值字典, 没有指定属性名时,其值是None
|
145
|
+
'''
|
146
|
+
@staticmethod
|
147
|
+
def GetCheck(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
148
|
+
'''
|
149
|
+
获取元素勾选状态(radio或checkbox)
|
150
|
+
|
151
|
+
isCheck = Web.GetCheck(target, onlyvis=False, index=None, fromElementTdid=None, continueOnError=False, delayAfter=100, delayBefore=100)
|
152
|
+
|
153
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
154
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
155
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
156
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
157
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
158
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
159
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
160
|
+
:return: 网页元素选中返回True,否则返回False
|
161
|
+
'''
|
162
|
+
@staticmethod
|
163
|
+
def GetChildren(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
|
164
|
+
'''
|
165
|
+
获取子元素
|
166
|
+
|
167
|
+
tdrpa_element_ids = Web.GetChildren(target, onlyvis=False, index=None, fromElementTdid=None, continueOnError=False, delayAfter=100, delayBefore=100)
|
168
|
+
|
169
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
170
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
171
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
172
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
173
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
174
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
175
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
176
|
+
:return: 网页元素的子元素的tdrpa_element_id列表
|
177
|
+
'''
|
178
|
+
@staticmethod
|
179
|
+
def GetHTML(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
180
|
+
"""
|
181
|
+
读取网页源码
|
182
|
+
|
183
|
+
htmlCode = Web.GetHTML(continueOnError=False, delayAfter=100, delayBefore=100)
|
184
|
+
|
185
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
186
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
187
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
188
|
+
:return:当前浏览器页面的 HTML 内容,无法获取时返回None
|
189
|
+
"""
|
190
|
+
@staticmethod
|
191
|
+
def GetParent(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, upLevels: int = 1, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
192
|
+
'''
|
193
|
+
获取父元素
|
194
|
+
|
195
|
+
tdrpa_element_id = Web.GetParent(target, onlyvis=False, index=None, fromElementTdid=None, upLevels=1, continueOnError=False, delayAfter=100, delayBefore=100)
|
196
|
+
|
197
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
198
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
199
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
200
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
201
|
+
:param upLevels: [可选参数]向上查找的层级数。默认1
|
202
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
203
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
204
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
205
|
+
:return: 网页元素的父元素的tdrpa_element_id,没有父元素时返回None
|
206
|
+
'''
|
207
|
+
@staticmethod
|
208
|
+
def GetRect(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, relative: str = 'screen', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
|
209
|
+
'''
|
210
|
+
获取元素位置大小
|
211
|
+
|
212
|
+
rectInfo = Web.GetRect(target, onlyvis=False, index=None, fromElementTdid=None, relative=\'screen\', continueOnError=False, delayAfter=100, delayBefore=100)
|
213
|
+
|
214
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
215
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
216
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
217
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
218
|
+
:param relative: [可选参数]相对坐标系。screen:相对屏幕坐标,parent:相对父级元素坐标。root:相对浏览器窗口内坐标。默认screen
|
219
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
220
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
221
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
222
|
+
:return: {\'x\':int, \'y\':int, \'width\':int, \'height\':int}
|
223
|
+
'''
|
224
|
+
@staticmethod
|
225
|
+
def GetScroll(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
|
226
|
+
"""
|
227
|
+
获取滚动条位置(像素)
|
228
|
+
|
229
|
+
location = Web.GetScroll(continueOnError=False, delayAfter=100, delayBefore=100)
|
230
|
+
|
231
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
232
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
233
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
234
|
+
:return:返回当前页面的滚动条位置,如 {'ScrollLeft': 20, 'ScrollTop': 1054},没有则返回None
|
235
|
+
"""
|
236
|
+
@staticmethod
|
237
|
+
def GetSelect(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, selectMode: str = 'text', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
|
238
|
+
'''
|
239
|
+
获取元素选中项(select)
|
240
|
+
|
241
|
+
selectedList = Web.GetSelect(target, onlyvis=False, index=None, fromElementTdid=None, selectMode="text", continueOnError=False, delayAfter=100, delayBefore=100)
|
242
|
+
|
243
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
244
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
245
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
246
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
247
|
+
:param selectMode: [可选参数]获取选中项的模式。\'text\':获取选中项的文本内容。\'value\':获取选中项的值。\'index\':获取选中项的索引。默认\'text\'
|
248
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
249
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
250
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
251
|
+
:return: 网页元素的选中项的文本内容或值列表,没有选中项时返回空列表
|
252
|
+
'''
|
253
|
+
@staticmethod
|
254
|
+
def GetSibling(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, position: str = 'next', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
255
|
+
'''
|
256
|
+
获取兄弟元素
|
257
|
+
|
258
|
+
tdrpa_element_id = Web.GetSibling(target, onlyvis=False, index=None, fromElementTdid=None, position=\'next\', continueOnError=False, delayAfter=100, delayBefore=100)
|
259
|
+
|
260
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
261
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
262
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
263
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
264
|
+
:param position: [可选参数]兄弟元素的位置。\'next\':下一个兄弟元素。\'prev\':上一个兄弟元素。默认\'next\'
|
265
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
266
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
267
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
268
|
+
:return: 网页元素的兄弟元素的tdrpa_element_id,没有兄弟元素时返回None
|
269
|
+
'''
|
270
|
+
@staticmethod
|
271
|
+
def GetTdElementId(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
272
|
+
'''
|
273
|
+
获取元素tdrpa_element_id
|
274
|
+
|
275
|
+
tdrpa_element_id = Web.GetTdElementId(target, onlyvis=False, index=None, fromElementTdid=None, continueOnError=False, delayAfter=100, delayBefore=100)
|
276
|
+
|
277
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
278
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
279
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
280
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
281
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
282
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
283
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
284
|
+
:return: 网页元素的tdrpa_element_id,没有找到时返回None
|
285
|
+
'''
|
286
|
+
@staticmethod
|
287
|
+
def GetTitle(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
288
|
+
"""
|
289
|
+
获取网页标题
|
290
|
+
|
291
|
+
title = Web.GetTitle(continueOnError=False, delayAfter=100, delayBefore=100)
|
292
|
+
|
293
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
294
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
295
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
296
|
+
:return: 网页标题
|
297
|
+
"""
|
298
|
+
@staticmethod
|
299
|
+
def GetURL(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
300
|
+
"""
|
301
|
+
获取网页URL
|
302
|
+
|
303
|
+
url = Web.GetURL(continueOnError=False, delayAfter=100, delayBefore=100)
|
304
|
+
|
305
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
306
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
307
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
308
|
+
:return: 网页链接
|
309
|
+
"""
|
310
|
+
@staticmethod
|
311
|
+
def GetValue(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, getMode: str = 'auto', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
312
|
+
'''
|
313
|
+
获取元素的文本值
|
314
|
+
|
315
|
+
text = Web.GetValue(target, onlyvis=False, index=None, fromElementTdid=None, getMode=\'auto\', continueOnError=False, delayAfter=100, delayBefore=100)
|
316
|
+
|
317
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
318
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
319
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
320
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
321
|
+
:param getMode: [可选参数]获取文本值的方式。\'auto\':自动获取,\'text\':获取元素内所有文本内容,\'innerText\':获取元素内可见文本内容,\'value\':获取元素值。默认\'auto\'
|
322
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
323
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
324
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
325
|
+
:return: 网页元素的文本值
|
326
|
+
'''
|
327
|
+
@staticmethod
|
328
|
+
def GoBack(waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
329
|
+
"""
|
330
|
+
执行后退操作(与浏览器工具栏的后退按钮功能相同)
|
331
|
+
|
332
|
+
Web.GoBack(waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
333
|
+
|
334
|
+
:param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
|
335
|
+
:param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
|
336
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
337
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
338
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
339
|
+
:return:None
|
340
|
+
"""
|
341
|
+
@staticmethod
|
342
|
+
def GoForward(waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
343
|
+
"""
|
344
|
+
执行前进操作(与浏览器工具栏的前进按钮功能相同)
|
345
|
+
|
346
|
+
Web.GoForward(waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
347
|
+
|
348
|
+
:param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
|
349
|
+
:param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
|
350
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
351
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
352
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
353
|
+
:return: None
|
354
|
+
"""
|
355
|
+
@staticmethod
|
356
|
+
def GoURL(url: str, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
357
|
+
'''
|
358
|
+
跳转至新网址
|
359
|
+
|
360
|
+
goResult = Web.GoURL(\'https://www.baidu.com\', waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
361
|
+
|
362
|
+
:param url:[必选参数]要加载的 URL(注意:url需要保留 "https://" 或 "http://" )。
|
363
|
+
:param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
|
364
|
+
:param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
|
365
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
366
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
367
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
368
|
+
:return: 跳转链接正确返回True,否则返回False
|
369
|
+
'''
|
370
|
+
@staticmethod
|
371
|
+
def Hover(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True, checkElementShow: bool = True, cursorPosition: str = 'center', cursorOffsetX: int = 0, cursorOffsetY: int = 0, keyModifiers: list = None, simulateType: str = 'simulate', moveSmoothly: bool = False) -> str | None:
|
372
|
+
'''
|
373
|
+
鼠标悬停到元素上
|
374
|
+
|
375
|
+
tdrpa_element_id = Web.Hover(target, onlyvis=False, index=None, fromElementTdid=None, delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, checkElementShow=True, cursorPosition=\'center\', cursorOffsetX=0, cursorOffsetY=0, keyModifiers=None, simulateType=\'simulate\', moveSmoothly=False)
|
376
|
+
|
377
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
378
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
379
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
380
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
381
|
+
:param delayTime: [可选参数]超时时间(毫秒)。默认10000
|
382
|
+
:param continueOnError: [可选参数]错误继续执行。默认False
|
383
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
384
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
385
|
+
:param setForeground: [可选参数]激活窗口。默认True
|
386
|
+
:param checkElementShow: [可选参数]检查元素是否可见。默认True
|
387
|
+
:param cursorPosition: [可选参数]鼠标位置。"center":元素中心,"left":元素左边界,"right":元素右边界,"top":元素上边界,"bottom":元素下边界。默认"center"
|
388
|
+
:param cursorOffsetX: [可选参数]鼠标偏移量X。默认0
|
389
|
+
:param cursorOffsetY: [可选参数]鼠标偏移量Y。默认0
|
390
|
+
:param keyModifiers: [可选参数]键盘修饰符。默认None
|
391
|
+
:param simulateType: [可选参数]模拟类型。"simulate":模拟悬浮,"api":接口悬浮。默认"simulate"
|
392
|
+
:param moveSmoothly: [可选参数]移动平滑(simulateType为api时会忽略此参数)。默认False。
|
393
|
+
:return: tdrpa_element_id
|
394
|
+
'''
|
395
|
+
@staticmethod
|
396
|
+
def InputText(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, content: str = '', clearOldText: bool = True, inputInterval: int = 30, delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True, validate: bool = False, simulateType: str = 'simulate', checkClickNum: int = 3, checkElementShow: bool = True, endToDo: str = None) -> str | None:
|
397
|
+
'''
|
398
|
+
填写输入框
|
399
|
+
|
400
|
+
tdrpa_element_id = Web.InputText(target, onlyvis=False, index=None, fromElementTdid=None, content=\'tdrpa\', clearOldText=True, inputInterval=30, delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, validate=False, simulateType=\'simulate\', checkClickNum=3, checkElementShow=True, endToDo=None)
|
401
|
+
|
402
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
403
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
404
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
405
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
406
|
+
:param content: [必选参数]输入的内容
|
407
|
+
:param clearOldText: [可选参数]是否先清空原内容。True:清空原有内容,False:在末尾追加录入。默认True
|
408
|
+
:param inputInterval: [可选参数]输入间隔,单位毫秒。默认30
|
409
|
+
:param delayTime: [可选参数]超时时间,单位毫秒。默认10000
|
410
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
411
|
+
:param delayAfter: [可选参数]延迟时间,单位毫秒。默认100
|
412
|
+
:param delayBefore: [可选参数]延迟时间,单位毫秒。默认100
|
413
|
+
:param setForeground: [可选参数]是否将元素置于前台。默认True
|
414
|
+
:param validate: [可选参数]是否验证输入内容。默认False
|
415
|
+
:param simulateType: [可选参数]输入前点击方式。\'simulate\':模拟点击,\'api\':接口点击。默认\'simulate\'
|
416
|
+
:param checkClickNum: [可选参数]检查点击次数。默认3
|
417
|
+
:param checkElementShow: [可选参数]是否检查元素是否在屏幕上。默认True
|
418
|
+
:param endToDo: [可选参数]输入完成后执行的操作。None:什么都不做。\'enter\':按回车键。\'blur\':使操作元素失去焦点。默认None
|
419
|
+
:return: tdrpa_element_id
|
420
|
+
'''
|
421
|
+
@staticmethod
|
422
|
+
def IsRunning(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
423
|
+
"""
|
424
|
+
检查浏览器是否运行
|
425
|
+
|
426
|
+
isRun = Web.IsRunning(continueOnError=False, delayAfter=100, delayBefore=100)
|
427
|
+
|
428
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
429
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
430
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
431
|
+
:return: 正在运行返回True,否则返回False
|
432
|
+
"""
|
433
|
+
@staticmethod
|
434
|
+
def MoveElementToScreen(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, moveMode: str = 'smoothCenter', delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
435
|
+
'''
|
436
|
+
将元素移动到屏幕中央
|
437
|
+
|
438
|
+
tdrpa_element_id = Web.MoveElementToScreen(target, onlyvis=False, index=None, fromElementTdid=None, moveMode=\'smoothCenter\', delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100)
|
439
|
+
|
440
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
441
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
442
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
443
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
444
|
+
:param moveMode: [可选参数]移动方式。\'smoothCenter\':平滑移动到元素中央。\'ifNeed\':如果元素不在浏览器可见区域再移动。\'fastCenter\':快速移动到元素中央。默认\'smoothCenter\'
|
445
|
+
:param delayTime: [可选参数]超时时间,单位毫秒。默认10000
|
446
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
447
|
+
:param delayAfter: [可选参数]执行后延时(毫秒)。默认100
|
448
|
+
:param delayBefore: [可选参数]执行前延时(毫秒)。默认100
|
449
|
+
:return: tdrpa_element_id
|
450
|
+
'''
|
451
|
+
@staticmethod
|
452
|
+
def Refresh(waitPage: bool = True, delayTime: int = 60000, passCache: bool = False, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
453
|
+
"""
|
454
|
+
刷新
|
455
|
+
|
456
|
+
Web.Refresh(waitPage=True, delayTime=60000, passCache=False, continueOnError=False, delayAfter=100, delayBefore=100)
|
457
|
+
|
458
|
+
:param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
|
459
|
+
:param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
|
460
|
+
:param passCache:[可选参数]是否要绕过本地缓存。默认为 False。
|
461
|
+
:param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
|
462
|
+
:param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
463
|
+
:param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
464
|
+
:return:None
|
465
|
+
"""
|
466
|
+
@staticmethod
|
467
|
+
def RunJS(js_str: str, isSync: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100):
|
468
|
+
"""
|
469
|
+
执行JS脚本
|
470
|
+
|
471
|
+
jsResult = Web.RunJS(js_str, isSync=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
472
|
+
|
473
|
+
:param js_str:[必选参数]要执行的JS脚本内容
|
474
|
+
:param isSync:[可选参数]是否同步执行,True:等待JS运行完成后才返回继续执行,传递为 false:JS开始执行立即返回
|
475
|
+
:param continueOnError:[可选参数]指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
|
476
|
+
:param delayAfter:[可选参数]执行活动后的延迟时间(以毫秒为单位)。默认时间为100毫秒
|
477
|
+
:param delayBefore:[可选参数]活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是100毫秒
|
478
|
+
:return:js运行结果
|
479
|
+
"""
|
480
|
+
@staticmethod
|
481
|
+
def ScreenShot(imgPath: str, imgName: str, rect: Incomplete | None = None, continueOnError: bool = False, delayAfter: int = 300, delayBefore: int = 100) -> None:
|
482
|
+
'''
|
483
|
+
网页截图
|
484
|
+
|
485
|
+
Web.ScreenShot("d:/", "test.png", rect=None, continueOnError=False, delayAfter=300, delayBefore=100)
|
486
|
+
|
487
|
+
:param imgPath:[必须参数]图片保存路径,如"d:/"
|
488
|
+
:param imgName:[必选参数]图片名称,如"test.png"
|
489
|
+
:param rect:[可选参数]截图的矩形范围,如:{"x": 0, "y": 0, "width": 200, "height": 200}。传递为 None 则截取整个标签页的显示区域。默认None
|
490
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
491
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认300
|
492
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
493
|
+
:return:None
|
494
|
+
'''
|
495
|
+
@staticmethod
|
496
|
+
def SetAttribute(target: str | dict, attrname: str, value: str, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
497
|
+
'''
|
498
|
+
设置元素属性值
|
499
|
+
|
500
|
+
setResult = Web.SetAttribute(target, attrname, value, onlyvis=False, index=None, fromElementTdid=None, continueOnError=False, delayAfter=100, delayBefore=100)
|
501
|
+
|
502
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
503
|
+
:param attrname: [必选参数]属性名称。
|
504
|
+
:param value: [必选参数]属性值。
|
505
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
506
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
507
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
508
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
509
|
+
:param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
510
|
+
:param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
511
|
+
:return: 设置成功返回True,否则返回False
|
512
|
+
'''
|
513
|
+
@staticmethod
|
514
|
+
def SetCheck(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, isCheck: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
515
|
+
'''
|
516
|
+
设置元素勾选状态(radio或checkbox)
|
517
|
+
|
518
|
+
setResult = Web.SetCheck(target, onlyvis=False, index=None, fromElementTdid=None, isCheck=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
519
|
+
|
520
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
521
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
522
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
523
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
524
|
+
:param isCheck: [可选参数]是否勾选。True:勾选,False:不勾选。默认True
|
525
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
526
|
+
:param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
527
|
+
:param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
528
|
+
:return: 设置成功返回True,否则返回False
|
529
|
+
'''
|
530
|
+
@staticmethod
|
531
|
+
def SetFocus(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, setForeground: bool = True, checkElementShow: bool = True, focusMode: str = 'focus', delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
532
|
+
'''
|
533
|
+
设置元素焦点
|
534
|
+
|
535
|
+
tdrpa_element_id = Web.SetFocus(target, onlyvis=False, index=None, fromElementTdid=None, setForeground=True, checkElementShow=True, focusMode=\'focus\', delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100)
|
536
|
+
|
537
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
538
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
539
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
540
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
541
|
+
:param setForeground: [可选参数]是否将元素设置为前台窗口。默认True
|
542
|
+
:param checkElementShow: [可选参数]是否检查元素是否可见。默认True
|
543
|
+
:param focusMode: [可选参数]焦点模式。\'focus\':获得焦点。\'blur\':离开焦点。默认\'focus\'
|
544
|
+
:param delayTime: [可选参数]等待元素出现的超时时间(毫秒)。默认10000
|
545
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
546
|
+
:param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
547
|
+
:param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
548
|
+
:return: tdrpa_element_id
|
549
|
+
'''
|
550
|
+
@staticmethod
|
551
|
+
def SetScroll(scrollPostion: dict, smooth: bool = True, waitTime: int = 2000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
|
552
|
+
'''
|
553
|
+
设置滚动条位置(像素)
|
554
|
+
|
555
|
+
position = Web.SetScroll({"ScrollLeft": 0, "ScrollTop": 500}, smooth=True, waitTime=2000, continueOnError=False, delayAfter=100, delayBefore=100)
|
556
|
+
|
557
|
+
:param scrollPostion:[可选参数]滚动条位置。如:{"ScrollLeft": 0,"ScrollTop": 0}
|
558
|
+
:param smooth:[可选参数]是否平滑滚动。True:平滑滚动到指定位置。False:迅速滚动到指定位置。默认True
|
559
|
+
:param waitTime:[可选参数]等待多长时间(毫秒)后返回滚动条位置,不能超过5000(毫秒)。默认2000
|
560
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
561
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
562
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
563
|
+
:return:返回当前页面的滚动条位置 如{\'ScrollLeft\': 0, \'ScrollTop\': 0},没有则返回None
|
564
|
+
'''
|
565
|
+
@staticmethod
|
566
|
+
def SetSelect(target: str | dict, selected: str | list | int, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, selectMode: str = 'text', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
567
|
+
'''
|
568
|
+
设置元素选中项(select)
|
569
|
+
|
570
|
+
Web.SetSelect(target, selected, onlyvis=False, index=None, fromElementTdid=None, selectMode="text", continueOnError=False, delayAfter=100, delayBefore=100)
|
571
|
+
|
572
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
573
|
+
:param selected: [必选参数]选中的值。str类型时:选中的值。list类型时:选中的值列表。int类型时:选中的值索引。
|
574
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
575
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
576
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
577
|
+
:param selectMode: [可选参数]设置选中项的模式。\'index\':根据索引选中。\'value\':根据值选中。\'text\':根据文本选中。默认\'text\'
|
578
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
579
|
+
:param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
580
|
+
:param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
581
|
+
:return: None
|
582
|
+
'''
|
583
|
+
@staticmethod
|
584
|
+
def SetValue(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, value: str = '', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
585
|
+
'''
|
586
|
+
设置元素的值
|
587
|
+
|
588
|
+
setResult = Web.SetValue(target, onlyvis=False, index=None, fromElementTdid=None, value=\'\', continueOnError=False, delayAfter=100, delayBefore=100)
|
589
|
+
|
590
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
591
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
592
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
593
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
594
|
+
:param value: [可选参数]要设置的值。默认\'\'
|
595
|
+
:param continueOnError: [可选参数]是否继续执行。默认False
|
596
|
+
:param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
|
597
|
+
:param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
|
598
|
+
:return: 返回设置完成的值
|
599
|
+
'''
|
600
|
+
@staticmethod
|
601
|
+
def Stop(delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 1000) -> bool | None:
|
602
|
+
"""
|
603
|
+
停止网页加载
|
604
|
+
|
605
|
+
stopResult = Web.Stop(delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=1000)
|
606
|
+
|
607
|
+
:param delayTime:[可选参数]超时时间(毫秒)。默认10000
|
608
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
609
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
610
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认1000
|
611
|
+
:return:页面停止成功返回True,失败返回False
|
612
|
+
"""
|
613
|
+
@staticmethod
|
614
|
+
def SwitchTab(matchTabContent: str = '', matchTabType: str = 'title', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
|
615
|
+
'''
|
616
|
+
切换浏览器标签页(可通过地址栏、标题栏进行匹配,支持包含匹配)
|
617
|
+
|
618
|
+
switchResult = Web.SwitchTab(\'百度\', matchTabType=\'title\', continueOnError=False, delayAfter=100, delayBefore=100)
|
619
|
+
|
620
|
+
:param matchTabContent: [必选参数]标签页匹配的内容,标题支持包含匹配,例如“百度”,链接支持包含匹配,例如“baidu”
|
621
|
+
:param matchTabType:[可选参数]标签页匹配的类型,\'title\':匹配标题。\'url\':匹配链接。默认"title"
|
622
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
623
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
624
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
625
|
+
:return: 切换成功返回True,失败返回False
|
626
|
+
'''
|
627
|
+
@staticmethod
|
628
|
+
def SetWindowState(ChromeWinState: str = 'topmost', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
629
|
+
"""
|
630
|
+
设置浏览器窗口状态
|
631
|
+
|
632
|
+
Web.SetWindowState(ChromeWinState='topmost', continueOnError=False, delayAfter=100, delayBefore=100)
|
633
|
+
|
634
|
+
:param ChromeWinState:[可选参数]浏览器窗口状态。'activate': 激活。'topmost':置顶并激活。'untop':取消置顶并移到底层显示。默认'topmost'
|
635
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
636
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
637
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
638
|
+
:return:None
|
639
|
+
"""
|
640
|
+
@staticmethod
|
641
|
+
def WaitElement(target: str | dict, onlyvis: bool = False, index: int = None, fromElementTdid: str = None, waitType: str = 'show', delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
|
642
|
+
'''
|
643
|
+
等待元素
|
644
|
+
|
645
|
+
tdrpa_element_id = Web.WaitElement(target, onlyvis=False, index=None, fromElementTdid=None, waitType=\'show\', delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
646
|
+
|
647
|
+
:param target: [必选参数]网页元素特征码。str类型时:tdSelector拾取的特征码,或css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
|
648
|
+
:param onlyvis: [可选参数]仅匹配可见元素。默认False
|
649
|
+
:param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
|
650
|
+
:param fromElementTdid: [可选参数]从哪个元素开始查找(注意:当target为tdSelector获取的特征码时该参数才有效)。None:从当前页面开始查找。tdrpa_element_id:从该元素开始查找。默认None
|
651
|
+
:param waitType: [可选参数]等待元素方式。\'show\':等待元素出现。\'hide\':等待元素消失。默认\'show\'
|
652
|
+
:param delayTime:[可选参数]超时时间(毫秒)。默认60000
|
653
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
654
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
655
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
656
|
+
:return:tdrpa_element_id
|
657
|
+
'''
|
658
|
+
@staticmethod
|
659
|
+
def WaitPage(delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100):
|
660
|
+
"""
|
661
|
+
等待网页加载完成
|
662
|
+
|
663
|
+
waitResult = Web.WaitPage(delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
|
664
|
+
|
665
|
+
:param delayTime:[可选参数]超时时间(毫秒)。默认60000
|
666
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
667
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
668
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
669
|
+
:return:页面加载完成返回True,未加载完成返回False
|
670
|
+
"""
|
671
|
+
|
672
|
+
class WebPW:
|
673
|
+
@staticmethod
|
674
|
+
def GetActivePage(delayTime: int = 10000, continueOnError: bool = False) -> Page:
|
675
|
+
"""
|
676
|
+
获取当前激活的页面
|
677
|
+
|
678
|
+
page = WebPW.GetActivePage(delayTime=10000, continueOnError=False)
|
679
|
+
|
680
|
+
:param delayTime: 查找延时(豪秒)。默认10000
|
681
|
+
:param continueOnError: 错误继续执行。默认False
|
682
|
+
:return: Page
|
683
|
+
"""
|
684
|
+
@staticmethod
|
685
|
+
def FindWebElement(target: str, anchorsElement: ElementHandle = None, delayTime: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
|
686
|
+
"""
|
687
|
+
查找元素
|
688
|
+
|
689
|
+
eh = WebPW.FindWebElement(target, anchorsElement=None, delayTime=10000, continueOnError=False, isVisible=True)
|
690
|
+
|
691
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
692
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
693
|
+
:param delayTime: 查找延时(豪秒)。默认10000
|
694
|
+
:param continueOnError: 错误继续执行。默认False
|
695
|
+
:param isVisible:检查是否可见。默认True
|
696
|
+
:return: ElementHandle
|
697
|
+
"""
|
698
|
+
@staticmethod
|
699
|
+
def Exists(target: str, anchorsElement: ElementHandle = None, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool:
|
700
|
+
"""
|
701
|
+
元素是否存在(不可见归于不存在)
|
702
|
+
|
703
|
+
WebPW.Exists(target, anchorsElement=None, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
704
|
+
|
705
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
706
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
707
|
+
:param isVisible:[可选参数]检查是否可见。默认True
|
708
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
709
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
710
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
711
|
+
:return:存在返回True,不存在返回False
|
712
|
+
"""
|
713
|
+
@staticmethod
|
714
|
+
def Wait(target: str, anchorsElement: ElementHandle = None, waitType: str = 'show', delayTime: int = 30000, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
715
|
+
'''
|
716
|
+
等待元素加载
|
717
|
+
|
718
|
+
WebPW.Wait(target, anchorsElement=None, waitType="show", delayTime=30000, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
719
|
+
|
720
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
721
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
722
|
+
:param waitType:[可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
|
723
|
+
:param delayTime:[可选参数]等待最大时间。默认30000毫秒(30秒)
|
724
|
+
:param isVisible:[可选参数]检查是否可见。默认True
|
725
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
726
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
727
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
728
|
+
:return:None
|
729
|
+
'''
|
730
|
+
@staticmethod
|
731
|
+
def GetParentElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
732
|
+
"""
|
733
|
+
获取父级元素
|
734
|
+
|
735
|
+
eh = WebPW.GetParentElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
736
|
+
|
737
|
+
:param eh:[必选参数]ElementHandle
|
738
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
739
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
740
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
741
|
+
:return:ElementHandle
|
742
|
+
"""
|
743
|
+
@staticmethod
|
744
|
+
def GetNextSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
745
|
+
"""
|
746
|
+
获取下一个兄弟元素
|
747
|
+
|
748
|
+
eh = WebPW.GetNextSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
749
|
+
|
750
|
+
:param eh:[必选参数]ElementHandle
|
751
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
752
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
753
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
754
|
+
:return:ElementHandle
|
755
|
+
"""
|
756
|
+
@staticmethod
|
757
|
+
def GetPreviousSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
758
|
+
"""
|
759
|
+
获取前一个兄弟元素
|
760
|
+
|
761
|
+
eh = WebPW.GetPreviousSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
762
|
+
|
763
|
+
:param eh:[必选参数]ElementHandle
|
764
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
765
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
766
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
767
|
+
:return:ElementHandle
|
768
|
+
"""
|
769
|
+
@staticmethod
|
770
|
+
def GetChildrenElements(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
|
771
|
+
"""
|
772
|
+
获取子节点
|
773
|
+
|
774
|
+
ehList = WebPW.GetChildrenElements(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
775
|
+
|
776
|
+
:param eh:[必选参数]ElementHandle
|
777
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
778
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
779
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
780
|
+
:return: list[ElementHandle, ElementHandle,...]
|
781
|
+
"""
|
782
|
+
@staticmethod
|
783
|
+
def Click(target: str | ElementHandle, button: str = 'left', clickType: str = 'click', anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
784
|
+
'''
|
785
|
+
点击元素
|
786
|
+
|
787
|
+
eh = WebPW.Click(target, button="left", clickType="click", anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
|
788
|
+
|
789
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
790
|
+
:param button:[可选参数]鼠标按键。left:左键,right:右键,middle:中键。默认left
|
791
|
+
:param clickType:[可选参数]点击方式。click 单击,dblclick 双击。默认click
|
792
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
793
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
794
|
+
:param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
|
795
|
+
:param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
|
796
|
+
:param delayTime:超时(豪秒)。默认10000
|
797
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
798
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
799
|
+
:return: ElementHandle
|
800
|
+
'''
|
801
|
+
@staticmethod
|
802
|
+
def Hover(target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
803
|
+
'''
|
804
|
+
鼠标悬停在元素上
|
805
|
+
|
806
|
+
eh = WebPW.Hover(target, anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
|
807
|
+
|
808
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
809
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
810
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
811
|
+
:param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
|
812
|
+
:param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
|
813
|
+
:param delayTime:超时(豪秒)。默认10000
|
814
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
815
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
816
|
+
:return: ElementHandle
|
817
|
+
'''
|
818
|
+
@staticmethod
|
819
|
+
def Input(text: str, target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
820
|
+
"""
|
821
|
+
输入文本
|
822
|
+
|
823
|
+
eh = WebPW.Input(text, target, anchorsElement=None, continueOnError=False, delayTime=10000, delayAfter=100, delayBefore=100)
|
824
|
+
|
825
|
+
:param text:[必选参数]文本内容
|
826
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
827
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
828
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
829
|
+
:param delayTime:超时(豪秒)。默认10000
|
830
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
831
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
832
|
+
:return: ElementHandle
|
833
|
+
"""
|
834
|
+
|
835
|
+
@staticmethod
|
836
|
+
def GetActivePage(delayTime: int = 10000, continueOnError: bool = False) -> Page:
|
837
|
+
"""
|
838
|
+
获取当前激活的页面
|
839
|
+
|
840
|
+
page = WebPW.GetActivePage(delayTime=10000, continueOnError=False)
|
841
|
+
|
842
|
+
:param delayTime: 查找延时(豪秒)。默认10000
|
843
|
+
:param continueOnError: 错误继续执行。默认False
|
844
|
+
:return: Page
|
845
|
+
"""
|
846
|
+
@staticmethod
|
847
|
+
def FindWebElement(target: str, anchorsElement: ElementHandle = None, delayTime: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
|
848
|
+
"""
|
849
|
+
查找元素
|
850
|
+
|
851
|
+
eh = WebPW.FindWebElement(target, anchorsElement=None, delayTime=10000, continueOnError=False, isVisible=True)
|
852
|
+
|
853
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
854
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
855
|
+
:param delayTime: 查找延时(豪秒)。默认10000
|
856
|
+
:param continueOnError: 错误继续执行。默认False
|
857
|
+
:param isVisible:检查是否可见。默认True
|
858
|
+
:return: ElementHandle
|
859
|
+
"""
|
860
|
+
@staticmethod
|
861
|
+
def Exists(target: str, anchorsElement: ElementHandle = None, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool:
|
862
|
+
"""
|
863
|
+
元素是否存在(不可见归于不存在)
|
864
|
+
|
865
|
+
WebPW.Exists(target, anchorsElement=None, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
866
|
+
|
867
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
868
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
869
|
+
:param isVisible:[可选参数]检查是否可见。默认True
|
870
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
871
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
872
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
873
|
+
:return:存在返回True,不存在返回False
|
874
|
+
"""
|
875
|
+
@staticmethod
|
876
|
+
def Wait(target: str, anchorsElement: ElementHandle = None, waitType: str = 'show', delayTime: int = 30000, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
|
877
|
+
'''
|
878
|
+
等待元素加载
|
879
|
+
|
880
|
+
WebPW.Wait(target, anchorsElement=None, waitType="show", delayTime=30000, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
|
881
|
+
|
882
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
|
883
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
884
|
+
:param waitType:[可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
|
885
|
+
:param delayTime:[可选参数]等待最大时间。默认30000毫秒(30秒)
|
886
|
+
:param isVisible:[可选参数]检查是否可见。默认True
|
887
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
888
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
889
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
890
|
+
:return:None
|
891
|
+
'''
|
892
|
+
@staticmethod
|
893
|
+
def GetParentElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
894
|
+
"""
|
895
|
+
获取父级元素
|
896
|
+
|
897
|
+
eh = WebPW.GetParentElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
898
|
+
|
899
|
+
:param eh:[必选参数]ElementHandle
|
900
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
901
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
902
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
903
|
+
:return:ElementHandle
|
904
|
+
"""
|
905
|
+
@staticmethod
|
906
|
+
def GetNextSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
907
|
+
"""
|
908
|
+
获取下一个兄弟元素
|
909
|
+
|
910
|
+
eh = WebPW.GetNextSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
911
|
+
|
912
|
+
:param eh:[必选参数]ElementHandle
|
913
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
914
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
915
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
916
|
+
:return:ElementHandle
|
917
|
+
"""
|
918
|
+
@staticmethod
|
919
|
+
def GetPreviousSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
920
|
+
"""
|
921
|
+
获取前一个兄弟元素
|
922
|
+
|
923
|
+
eh = WebPW.GetPreviousSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
924
|
+
|
925
|
+
:param eh:[必选参数]ElementHandle
|
926
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
927
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
928
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
929
|
+
:return:ElementHandle
|
930
|
+
"""
|
931
|
+
@staticmethod
|
932
|
+
def GetChildrenElements(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
|
933
|
+
"""
|
934
|
+
获取子节点
|
935
|
+
|
936
|
+
ehList = WebPW.GetChildrenElements(eh, continueOnError=False, delayAfter=100, delayBefore=100)
|
937
|
+
|
938
|
+
:param eh:[必选参数]ElementHandle
|
939
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
940
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
941
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
942
|
+
:return: list[ElementHandle, ElementHandle,...]
|
943
|
+
"""
|
944
|
+
@staticmethod
|
945
|
+
def Click(target: str | ElementHandle, button: str = 'left', clickType: str = 'click', anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
946
|
+
'''
|
947
|
+
点击元素
|
948
|
+
|
949
|
+
eh = WebPW.Click(target, button="left", clickType="click", anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
|
950
|
+
|
951
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
952
|
+
:param button:[可选参数]鼠标按键。left:左键,right:右键,middle:中键。默认left
|
953
|
+
:param clickType:[可选参数]点击方式。click 单击,dblclick 双击。默认click
|
954
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
955
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
956
|
+
:param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
|
957
|
+
:param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
|
958
|
+
:param delayTime:超时(豪秒)。默认10000
|
959
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
960
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
961
|
+
:return: ElementHandle
|
962
|
+
'''
|
963
|
+
@staticmethod
|
964
|
+
def Hover(target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, position: dict = None, keyModifiers: list = None, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
965
|
+
'''
|
966
|
+
鼠标悬停在元素上
|
967
|
+
|
968
|
+
eh = WebPW.Hover(target, anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
|
969
|
+
|
970
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
971
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
972
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
973
|
+
:param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
|
974
|
+
:param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
|
975
|
+
:param delayTime:超时(豪秒)。默认10000
|
976
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
977
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
978
|
+
:return: ElementHandle
|
979
|
+
'''
|
980
|
+
@staticmethod
|
981
|
+
def Input(text: str, target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
|
982
|
+
"""
|
983
|
+
输入文本
|
984
|
+
|
985
|
+
eh = WebPW.Input(text, target, anchorsElement=None, continueOnError=False, delayTime=10000, delayAfter=100, delayBefore=100)
|
986
|
+
|
987
|
+
:param text:[必选参数]文本内容
|
988
|
+
:param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
|
989
|
+
:param anchorsElement:[可选参数]锚点元素,默认None
|
990
|
+
:param continueOnError:[可选参数]错误继续执行。默认False
|
991
|
+
:param delayTime:超时(豪秒)。默认10000
|
992
|
+
:param delayAfter:[可选参数]执行后延时(毫秒)。默认100
|
993
|
+
:param delayBefore:[可选参数]执行前延时(毫秒)。默认100
|
994
|
+
:return: ElementHandle
|
995
|
+
"""
|