tdrpa.tdworker 1.1.10.3__py311-none-win_amd64.whl → 1.2.11.1__py311-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.
@@ -4,7 +4,7 @@ from ._img import Image as Image
4
4
  from ._os import App as App
5
5
  from ._sp import PrintToScreen as PrintToScreen
6
6
  from ._w import Window as Window
7
- from ._web import ChromePlugin as ChromePlugin, Web as Web
7
+ from ._web import Web as Web, WebPW as WebPW
8
8
  from ._winE import WinElement as WinElement
9
9
  from ._winK import WinKeyboard as WinKeyboard
10
10
  from ._winM import WinMouse as WinMouse
tdrpa/tdworker/_img.pyi CHANGED
@@ -1,7 +1,5 @@
1
- from _typeshed import Incomplete
2
1
  import uiautomation as uia
3
-
4
- SCT: Incomplete
2
+ from _typeshed import Incomplete
5
3
 
6
4
  class Image:
7
5
  @staticmethod
@@ -212,4 +210,17 @@ class Image:
212
210
  :param relativeType:[可选参数]查找坐标相对类型。screen:返回相对屏幕的坐标,以屏幕左上角0,0为坐标原点。 image:返回相对查找范围的坐标,以查找范围的左上角0,0为坐标原点。默认screen
213
211
  :return:返回找到的坐标,如{"x":int, "y":int}。找不到返回None
214
212
  '''
213
+ @staticmethod
214
+ def CaptureScreen(filePath: str, rect: dict | None = None, continueOnError: bool = False, delayAfter: int = 300, delayBefore: int = 100):
215
+ '''
216
+ 屏幕截图
215
217
 
218
+ Image.CaptureScreen("E:/1.png", rect=None, continueOnError=False, delayAfter=300, delayBefore=100)
219
+
220
+ :param filePath:[必选参数]保存的图片路径,如"E:/1.png"
221
+ :param rect:[可选参数]需要截取的范围。{"x": int, "y": int, "width": int, "height": int}:程序会在屏幕这个范围内进行截图。如果范围传递为 None,则进行屏幕截图
222
+ :param continueOnError:[可选参数]错误继续执行。
223
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认300
224
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
225
+ :return:None
226
+ '''
tdrpa/tdworker/_web.pyi CHANGED
@@ -3,227 +3,807 @@ from playwright.sync_api import ElementHandle, Page as Page
3
3
 
4
4
  class Web:
5
5
  @staticmethod
6
- def Exists(tdstr: str, anchorsElement, isVisible: bool = True) -> bool:
6
+ def Click(target: str | dict, onlyvis: bool = False, index: int = 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, 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类型时: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 button: [可选参数]鼠标点击。鼠标左键:"left" 鼠标右键:"right" 鼠标中键:"middle"。默认"left"
16
+ :param clickType: [可选参数]点击类型。单击:"click" 双击:"dblclick" 按下:"down" 弹起:"up"。默认"click"
17
+ :param delayTime: [可选参数]超时时间(毫秒)。默认10000
18
+ :param continueOnError: [可选参数]错误继续执行。默认False
19
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
20
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
21
+ :param setForeground: [可选参数]激活窗口。默认True
22
+ :param checkElementShow: [可选参数]检查元素是否可见。默认True
23
+ :param cursorPosition: [可选参数]光标位置。中心:"center" 左上角:"topLeft" 右上角:"topRight" 左下角:"bottomLeft" 右下角:"bottomRight"。默认"center"
24
+ :param cursorOffsetX: [可选参数]横坐标偏移。默认0
25
+ :param cursorOffsetY: [可选参数]纵坐标偏移。默认0
26
+ :param keyModifiers: [可选参数]辅助按键["Alt","Ctrl","Shift","Win"]可多选。默认None
27
+ :param simulateType: [可选参数]操作类型。模拟操作:"simulate" 接口操作:"api"。默认"simulate"
28
+ :param moveSmoothly: [可选参数]是否平滑移动鼠标(simulateType为api时会忽略此参数)。默认False
29
+ :return: tdrpa_element_id
30
+ '''
31
+ @staticmethod
32
+ def CloseBrowser(tryClose: int = 3, userData: str = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
7
33
  """
8
- 元素是否存在(不可见归于不存在)
34
+ 关闭浏览器
9
35
 
10
- Web.Exists(tdstr, page, isVisible=True)
36
+ Web.CloseBrowser(tryClose=3, userData=None, continueOnError=False, delayAfter=100, delayBefore=100)
11
37
 
12
- :param tdstr: td字符串
13
- :param anchorsElement: 锚点参数
14
- :param isVisible:[可选参数]检查是否可见。默认True
15
- :return: bool
38
+ :param tryClose:[可选参数]尝试关闭浏览器的次数。默认值为 3。如果在指定次数内无法成功关闭浏览器,则会抛出异常。
39
+ :param userData:[可选参数]用户数据目录的路径。如果未提供,则使用默认路径。
40
+ :param continueOnError:[可选参数]是否在发生错误时继续执行。默认值为 False。
41
+ :param delayAfter:[可选参数]延迟关闭浏览器的时间(毫秒)。默认值为 100。
42
+ :param delayBefore:[可选参数]延迟关闭浏览器之前的时间(毫秒)。默认值为 100。
43
+ :return: None
44
+ """
45
+ @staticmethod
46
+ def CloseTab(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
47
+ """
48
+ 关闭当前标签页
49
+
50
+ closeResult = Web.CloseTab(continueOnError=False, delayAfter=100, delayBefore=100)
51
+
52
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
53
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
54
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
55
+ :return: 关闭成功返回True,失败返回False。只有一个标签页时不能关闭,会返回False
56
+ """
57
+ @staticmethod
58
+ def CreateBrowser(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportMode: str = 'uia', userData: Incomplete | None = None, clearChrome: bool = True, otherStartupParam: Incomplete | None = None, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
59
+ """
60
+ 创建浏览器
61
+
62
+ Web.CreateBrowser(url='https://www.baidu.com', chromeExePath=None, isMaximize=True, supportMode='uia', userData=None, clearChrome=True, otherStartupParam=None, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
63
+
64
+ :param url:[可选参数]启动浏览器后打开的链接,字符串类型。默认None
65
+ :param chromeExePath:[可选参数]谷歌浏览器可执行程序的绝对路径,字符串类型,填写None时会自动寻找本地安装的路径。默认None
66
+ :param isMaximize:[可选参数]浏览器启动后是否最大化显示,选择True时最大化启动,选择False默认状态。默认True
67
+ :param supportMode:[可选参数]浏览器支持模式,'uia': 支持uia模式,'pw': 支持playwright模式。默认'uia'
68
+ :param userData:[可选参数]浏览器用户数据存放位置
69
+ :param clearChrome:[可选参数]是否在打开新浏览器之前关闭所有现有 Chrome 进程。默认值为 True。
70
+ :param otherStartupParam:[可选参数]其他启动谷歌浏览器的参数,如:['--xxx', '--xxx']。默认None
71
+ :param waitPage:[可选参数]是否等待页面加载完成。默认True
72
+ :param delayTime: 超时时间(毫秒)。默认60000
73
+ :param continueOnError:[可选参数]错误继续执行。默认False
74
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
75
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
76
+ :return:None
16
77
  """
17
78
  @staticmethod
18
- def Wait(tdstr: str, anchorsElement, waitType: str = 'show', searchDelay: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> None:
79
+ 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:
19
80
  '''
20
- 等待元素加载
81
+ 新建标签页
82
+
83
+ urlResult = Web.CreateTab(url="https://www.baidu.com", tabActive=True, waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
84
+
85
+ :param url:[可选参数]要加载的 URL(注意:url需要保留 "https://" 或 "http://" )。如果为 None,加载默认页面。
86
+ :param tabActive:[可选参数]是否激活新标签页。默认值为 True。
87
+ :param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
88
+ :param delayTime: [可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
89
+ :param continueOnError:[可选参数]错误继续执行。默认False
90
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
91
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
92
+ :return:url是None时,返回None,url有具体链接时,返回True或False,代表是否打开了目标链接
93
+ '''
94
+ @staticmethod
95
+ def Exists(target: str | dict, onlyvis: bool = False, index: int = None, returnType: str = 'id', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | str | None:
96
+ '''
97
+ 元素是否存在
98
+
99
+ tdrpa_element_id = Web.Exists(target, onlyvis=False, index=None, returnType=\'id\', continueOnError=False, delayAfter=100, delayBefore=100)
100
+
101
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
102
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
103
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
104
+ :param returnType:[可选参数]返回值的类型。设为\'bool\'时:网页元素存在,结果返回True,否则返回False,设为\'id\'时:网页元素存在,返回tdrpa_element_id,否则返回None.默认id
105
+ :param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
106
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
107
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
108
+ :return:元素存在返回tdrpa_element_id或True,不存在返回None或False(返回类型根据returnType字段设置值而定)。
109
+ '''
110
+ @staticmethod
111
+ def GetAllElements(target: str | dict, onlyvis: bool = False, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
112
+ '''
113
+ 获取指定特征所有元素
21
114
 
22
- Web.Wait(tdstr, page, waitType=\'show\', searchDelay=10000, continueOnError=False, isVisible=True)
115
+ tdrpa_element_ids = Web.GetAllElements(target, onlyvis=False, continueOnError=False, delayAfter=100, delayBefore=100)
23
116
 
24
- :param tdstr: td字符串
25
- :param anchorsElement: 锚点元素
26
- :param waitType: [可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
27
- :param searchDelay:[可选参数]等待最大时间。默认10000毫秒(10秒)
117
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
118
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
119
+ :param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
120
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
121
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
122
+ :return:所有目标元素的tdrpa_element_id列表
123
+ '''
124
+ @staticmethod
125
+ def GetAttribute(target: str | dict, onlyvis: bool = False, index: int = None, attrname: str = 'class', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
126
+ '''
127
+ 获取网页元素属性值
128
+
129
+ attrValue = Web.GetAttribute(target, onlyvis=False, index=None, attrname=\'class\', continueOnError=False, delayAfter=100, delayBefore=100)
130
+
131
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
132
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
133
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
134
+ :param attrname: [可选参数]属性名。默认为\'class\'
135
+ :param continueOnError:[可选参数]是否在发生错误时继续执行。默认为False。
136
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100。
137
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100。
138
+ :return:属性值字符串, 没有该属性时返回None
139
+ '''
140
+ @staticmethod
141
+ def GetCheck(target: str | dict, onlyvis: bool = False, index: int = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
142
+ '''
143
+ 获取元素勾选状态(radio或checkbox)
144
+
145
+ isCheck = Web.GetCheck(target, onlyvis=False, index=None, continueOnError=False, delayAfter=100, delayBefore=100)
146
+
147
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
148
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
149
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
28
150
  :param continueOnError: [可选参数]错误继续执行。默认False
29
- :param isVisible:[可选参数]检查是否可见。默认True
30
- :return: None
151
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
152
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
153
+ :return: 网页元素选中返回True,否则返回False
154
+ '''
155
+ @staticmethod
156
+ def GetChildren(target: str | dict, onlyvis: bool = False, index: int = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
157
+ '''
158
+ 获取子元素
159
+
160
+ tdrpa_element_ids = Web.GetChildren(target, onlyvis=False, index=None, continueOnError=False, delayAfter=100, delayBefore=100)
161
+
162
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
163
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
164
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
165
+ :param continueOnError: [可选参数]错误继续执行。默认False
166
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
167
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
168
+ :return: 网页元素的子元素的tdrpa_element_id列表
31
169
  '''
32
170
  @staticmethod
33
- def GetParentElement(eh: ElementHandle) -> ElementHandle:
171
+ def GetHTML(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
34
172
  """
35
- 获取父级元素
173
+ 读取网页源码
36
174
 
37
- eh = Web.GetParentElement(eh)
175
+ htmlCode = Web.GetHTML(continueOnError=False, delayAfter=100, delayBefore=100)
38
176
 
39
- :param eh: ElementHandle
40
- :return: ElementHandle
177
+ :param continueOnError:[可选参数]错误继续执行。默认False
178
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
179
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
180
+ :return:当前浏览器页面的 HTML 内容,无法获取时返回None
41
181
  """
42
182
  @staticmethod
43
- def GetNextSiblingElement(eh: ElementHandle) -> ElementHandle:
183
+ def GetParent(target: str | dict, onlyvis: bool = False, index: int = None, upLevels: int = 1, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
184
+ '''
185
+ 获取父元素
186
+
187
+ tdrpa_element_id = Web.GetParent(target, onlyvis=False, index=None, upLevels=1, continueOnError=False, delayAfter=100, delayBefore=100)
188
+
189
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
190
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
191
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
192
+ :param upLevels: [可选参数]向上查找的层级数。默认1
193
+ :param continueOnError: [可选参数]错误继续执行。默认False
194
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
195
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
196
+ :return: 网页元素的父元素的tdrpa_element_id,没有父元素时返回None
197
+ '''
198
+ @staticmethod
199
+ def GetRect(target: str | dict, onlyvis: bool = False, index: int = None, relative: str = 'screen', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
200
+ '''
201
+ 获取元素位置大小
202
+
203
+ rectInfo = Web.GetRect(target, onlyvis=False, index=None, relative=\'screen\', continueOnError=False, delayAfter=100, delayBefore=100)
204
+
205
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
206
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
207
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
208
+ :param relative: [可选参数]相对坐标系。screen:相对屏幕坐标,parent:相对父级元素坐标。root:相对浏览器窗口内坐标。默认screen
209
+ :param continueOnError: [可选参数]错误继续执行。默认False
210
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
211
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
212
+ :return: {\'x\':int, \'y\':int, \'width\':int, \'height\':int}
213
+ '''
214
+ @staticmethod
215
+ def GetScroll(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
44
216
  """
45
- 获取下一个兄弟元素
217
+ 获取滚动条位置(像素)
46
218
 
47
- eh = Web.GetNextSiblingElement(eh)
219
+ location = Web.GetScroll(continueOnError=False, delayAfter=100, delayBefore=100)
48
220
 
49
- :param eh: ElementHandle
50
- :return: ElementHandle
221
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
222
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
223
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
224
+ :return:返回当前页面的滚动条位置,如 {'ScrollLeft': 20, 'ScrollTop': 1054},没有则返回None
51
225
  """
52
226
  @staticmethod
53
- def GetPreviousSiblingElement(eh: ElementHandle) -> ElementHandle:
227
+ def GetSelect(target: str | dict, onlyvis: bool = False, index: int = None, selectMode: str = 'text', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
228
+ '''
229
+ 获取元素选中项(select)
230
+
231
+ selectedList = Web.GetSelect(target, onlyvis=False, index=None, selectMode="text", continueOnError=False, delayAfter=100, delayBefore=100)
232
+
233
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
234
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
235
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
236
+ :param selectMode: [可选参数]获取选中项的模式。\'text\':获取选中项的文本内容。\'value\':获取选中项的值。\'index\':获取选中项的索引。默认\'text\'
237
+ :param continueOnError: [可选参数]错误继续执行。默认False
238
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
239
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
240
+ :return: 网页元素的选中项的文本内容或值列表,没有选中项时返回空列表
241
+ '''
242
+ @staticmethod
243
+ def GetSibling(target: str | dict, onlyvis: bool = False, index: int = None, position: str = 'next', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
244
+ '''
245
+ 获取兄弟元素
246
+
247
+ tdrpa_element_id = Web.GetSibling(target, onlyvis=False, index=None, position=\'next\', continueOnError=False, delayAfter=100, delayBefore=100)
248
+
249
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
250
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
251
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
252
+ :param position: [可选参数]兄弟元素的位置。\'next\':下一个兄弟元素。\'prev\':上一个兄弟元素。默认\'next\'
253
+ :param continueOnError: [可选参数]错误继续执行。默认False
254
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
255
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
256
+ :return: 网页元素的兄弟元素的tdrpa_element_id,没有兄弟元素时返回None
257
+ '''
258
+ @staticmethod
259
+ def GetTdElementId(target: str | dict, onlyvis: bool = False, index: int = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
260
+ '''
261
+ 获取元素tdrpa_element_id
262
+
263
+ tdrpa_element_id = Web.GetTdElementId(target, onlyvis=False, index=None, continueOnError=False, delayAfter=100, delayBefore=100)
264
+
265
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
266
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
267
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
268
+ :param continueOnError: [可选参数]错误继续执行。默认False
269
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
270
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
271
+ :return: 网页元素的tdrpa_element_id,没有找到时返回None
272
+ '''
273
+ @staticmethod
274
+ def GetTitle(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
54
275
  """
55
- 获取前一个兄弟元素
276
+ 获取网页标题
56
277
 
57
- eh = Web.GetPreviousSiblingElement(eh)
278
+ title = Web.GetTitle(continueOnError=False, delayAfter=100, delayBefore=100)
58
279
 
59
- :param eh: ElementHandle
60
- :return: ElementHandle
280
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
281
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
282
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
283
+ :return: 网页标题
61
284
  """
62
285
  @staticmethod
63
- def GetChildrenElements(eh) -> list:
286
+ def GetURL(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
64
287
  """
65
- 获取子节点
288
+ 获取网页URL
66
289
 
67
- ehList = Web.GetChildrenElements(eh)
290
+ url = Web.GetURL(continueOnError=False, delayAfter=100, delayBefore=100)
68
291
 
69
- :param eh: ElementHandle
70
- :return: list[ElementHandle, ElementHandle, ...]
292
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
293
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
294
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
295
+ :return: 网页链接
71
296
  """
72
297
  @staticmethod
73
- def Click(target: str | ElementHandle, anchorsElement: Incomplete | None = None, position: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
298
+ def GetValue(target: str | dict, onlyvis: bool = False, index: int = None, getMode: str = 'auto', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
299
+ '''
300
+ 获取元素的文本值
301
+
302
+ text = Web.GetValue(target, onlyvis=False, index=None, getMode=\'auto\', continueOnError=False, delayAfter=100, delayBefore=100)
303
+
304
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
305
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
306
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
307
+ :param getMode: [可选参数]获取文本值的方式。\'auto\':自动获取,\'text\':获取元素内所有文本内容,\'innerText\':获取元素内可见文本内容,\'value\':获取元素值。默认\'auto\'
308
+ :param continueOnError: [可选参数]错误继续执行。默认False
309
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
310
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
311
+ :return: 网页元素的文本值
312
+ '''
313
+ @staticmethod
314
+ def GoBack(waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
74
315
  """
75
- 点击元素
316
+ 执行后退操作(与浏览器工具栏的后退按钮功能相同)
76
317
 
77
- eh = Web.Click(target, page, position=None, delayTime=10000)
318
+ Web.GoBack(waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
78
319
 
79
- :param target: tdstr 或 ElementHandle
80
- :param anchorsElement: 锚点元素
81
- :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
82
- :param delayTime: 超时(豪秒)。默认10000
83
- :return: ElementHandle
320
+ :param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
321
+ :param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
322
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
323
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
324
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
325
+ :return:None
84
326
  """
85
327
  @staticmethod
86
- def Hover(target: str | ElementHandle, anchorsElement: Incomplete | None = None, position: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
328
+ def GoForward(waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
87
329
  """
88
- 鼠标悬停在元素上
330
+ 执行前进操作(与浏览器工具栏的前进按钮功能相同)
89
331
 
90
- eh = Web.Hover(target, page, position=None, delayTime=10000)
332
+ Web.GoForward(waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
91
333
 
92
- :param target: tdstr 或 ElementHandle
93
- :param anchorsElement: 锚点元素
94
- :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
95
- :param delayTime: 超时(豪秒)。默认10000
96
- :return: ElementHandle
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
97
340
  """
98
341
  @staticmethod
99
- def Input(text, target, anchorsElement: Incomplete | None = None, delayTime: int = 10000) -> ElementHandle:
342
+ def GoURL(url: str, waitPage: bool = True, delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
343
+ '''
344
+ 跳转至新网址
345
+
346
+ goResult = Web.GoURL(\'https://www.baidu.com\', waitPage=True, delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
347
+
348
+ :param url:[必选参数]要加载的 URL(注意:url需要保留 "https://" 或 "http://" )。
349
+ :param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
350
+ :param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
351
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
352
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
353
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
354
+ :return: 跳转链接正确返回True,否则返回False
355
+ '''
356
+ @staticmethod
357
+ def Hover(target: str | dict, onlyvis: bool = False, index: int = 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:
358
+ '''
359
+ 鼠标悬停到元素上
360
+
361
+ tdrpa_element_id = Web.Hover(target, onlyvis=False, index=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)
362
+
363
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
364
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
365
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
366
+ :param delayTime: [可选参数]超时时间(毫秒)。默认10000
367
+ :param continueOnError: [可选参数]错误继续执行。默认False
368
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
369
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
370
+ :param setForeground: [可选参数]激活窗口。默认True
371
+ :param checkElementShow: [可选参数]检查元素是否可见。默认True
372
+ :param cursorPosition: [可选参数]鼠标位置。"center":元素中心,"left":元素左边界,"right":元素右边界,"top":元素上边界,"bottom":元素下边界。默认"center"
373
+ :param cursorOffsetX: [可选参数]鼠标偏移量X。默认0
374
+ :param cursorOffsetY: [可选参数]鼠标偏移量Y。默认0
375
+ :param keyModifiers: [可选参数]键盘修饰符。默认None
376
+ :param simulateType: [可选参数]模拟类型。"simulate":模拟悬浮,"api":接口悬浮。默认"simulate"
377
+ :param moveSmoothly: [可选参数]移动平滑(simulateType为api时会忽略此参数)。默认False。
378
+ :return: tdrpa_element_id
379
+ '''
380
+ @staticmethod
381
+ def InputText(target: str | dict, onlyvis: bool = False, index: int = 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', checkElementShow: bool = True, endToDo: str = None) -> str | None:
382
+ '''
383
+ 填写输入框
384
+
385
+ tdrpa_element_id = Web.InputText(target, onlyvis=False, index=None, content=\'tdrpa\', clearOldText=True, inputInterval=30, delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True, validate=False, simulateType=\'simulate\', checkElementShow=True, endToDo=None)
386
+
387
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
388
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
389
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
390
+ :param content: [必选参数]输入的内容
391
+ :param clearOldText: [可选参数]是否先清空原内容。True:清空原有内容,False:在末尾追加录入。默认True
392
+ :param inputInterval: [可选参数]输入间隔,单位毫秒。默认30
393
+ :param delayTime: [可选参数]超时时间,单位毫秒。默认10000
394
+ :param continueOnError: [可选参数]是否继续执行。默认False
395
+ :param delayAfter: [可选参数]延迟时间,单位毫秒。默认100
396
+ :param delayBefore: [可选参数]延迟时间,单位毫秒。默认100
397
+ :param setForeground: [可选参数]是否将元素置于前台。默认True
398
+ :param validate: [可选参数]是否验证输入内容。默认False
399
+ :param simulateType: [可选参数]输入前点击方式。\'simulate\':模拟点击,\'api\':接口点击。默认\'simulate\'
400
+ :param checkElementShow: [可选参数]是否检查元素是否在屏幕上。默认True
401
+ :param endToDo: [可选参数]输入完成后执行的操作。None:什么都不做。\'enter\':按回车键。\'blur\':使操作元素失去焦点。默认None
402
+ :return: tdrpa_element_id
403
+ '''
404
+ @staticmethod
405
+ def IsRunning(continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
100
406
  """
101
- 输入文本
407
+ 检查浏览器是否运行
102
408
 
103
- eh = Web.Input(text, target, page, delayTime=10000)
409
+ isRun = Web.IsRunning(continueOnError=False, delayAfter=100, delayBefore=100)
104
410
 
105
- :param text: 文本内容
106
- :param target: tdstr 或 ElementHandle
107
- :param anchorsElement: 锚点元素
108
- :param delayTime: 超时(豪秒)。默认10000
109
- :return: ElementHandle
411
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
412
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
413
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
414
+ :return: 正在运行返回True,否则返回False
110
415
  """
111
416
  @staticmethod
112
- def ClickLinkOpenNewPage(eh, position: Incomplete | None = None, waitLoad: bool = False) -> Page:
417
+ def MoveElementToScreen(target: str | dict, onlyvis: bool = False, index: int = None, moveMode: str = 'smoothCenter', delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
418
+ '''
419
+ 将元素移动到屏幕中央
420
+
421
+ tdrpa_element_id = Web.MoveElementToScreen(target, onlyvis=False, index=None, moveMode=\'smoothCenter\', delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100)
422
+
423
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
424
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
425
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
426
+ :param moveMode: [可选参数]移动方式。\'smoothCenter\':平滑移动到元素中央。\'ifNeed\':如果元素不在浏览器可见区域再移动。\'fastCenter\':快速移动到元素中央。默认\'smoothCenter\'
427
+ :param delayTime: [可选参数]超时时间,单位毫秒。默认10000
428
+ :param continueOnError: [可选参数]是否继续执行。默认False
429
+ :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
430
+ :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
431
+ :return: tdrpa_element_id
432
+ '''
433
+ @staticmethod
434
+ def Refresh(waitPage: bool = True, delayTime: int = 60000, passCache: bool = False, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
113
435
  """
114
- 点击连接产生新的标签页
436
+ 刷新
115
437
 
116
- newPage = Web.ClickLinkOpenNewPage(eh, position=None, waitLoad=False)
438
+ Web.Refresh(waitPage=True, delayTime=60000, passCache=False, continueOnError=False, delayAfter=100, delayBefore=100)
117
439
 
118
- :param eh: ElementHandle
119
- :param position: 以元素左上角偏移量{'x': 0, 'y': 0},None时点击中心
120
- :param waitLoad: 是否等待新页面加载完毕。默认False
121
- :return: newPage
440
+ :param waitPage:[可选参数]是否等待页面加载完成。True:等待页面加载完毕,False:不等待页面加载完毕。默认值为 True。
441
+ :param delayTime:[可选参数]waitPage为True时,网页等待超时时间,默认为 60000 毫秒(60秒)
442
+ :param passCache:[可选参数]是否要绕过本地缓存。默认为 False
443
+ :param continueOnError:[可选参数]是否继续执行后续步骤。默认值为 False。
444
+ :param delayAfter:[可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
445
+ :param delayBefore:[可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
446
+ :return:None
122
447
  """
123
448
  @staticmethod
124
- def FindWebElement(tdstr: str, anchorsElement, searchDelay: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
449
+ def RunJS(js_str: str, isSync: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100):
125
450
  """
126
- 查找元素
451
+ 执行JS脚本
127
452
 
128
- eh = Web.FindWebElement(tdstr, page, searchDelay=10000, continueOnError=False, isVisible=True)
453
+ jsResult = Web.RunJS(js_str, isSync=True, continueOnError=False, delayAfter=100, delayBefore=100)
129
454
 
130
- :param tdstr: td字符串
131
- :param anchorsElement: 锚点参数
132
- :param searchDelay: 查找延时(豪秒)。默认10000
133
- :param continueOnError: 错误继续执行。默认False
134
- :param isVisible:检查是否可见。默认True
135
- :return: ElementHandle
455
+ :param js_str:[必选参数]要执行的JS脚本内容
456
+ :param isSync:[可选参数]是否同步执行,True:等待JS运行完成后才返回继续执行,传递为 false:JS开始执行立即返回
457
+ :param continueOnError:[可选参数]指定即使活动引发错误,自动化是否仍应继续。该字段仅支持布尔值(True,False)。默认值为False
458
+ :param delayAfter:[可选参数]执行活动后的延迟时间(以毫秒为单位)。默认时间为100毫秒
459
+ :param delayBefore:[可选参数]活动开始执行任何操作之前的延迟时间(以毫秒为单位)。默认的时间量是100毫秒
460
+ :return:js运行结果
136
461
  """
137
462
  @staticmethod
138
- def PwStart(port: int = 9222, magic: bool = True) -> Page:
463
+ def ScreenShot(imgPath: str, imgName: str, rect: Incomplete | None = None, continueOnError: bool = False, delayAfter: int = 300, delayBefore: int = 100) -> None:
464
+ '''
465
+ 网页截图
466
+
467
+ Web.ScreenShot("d:/", "test.png", rect=None, continueOnError=False, delayAfter=300, delayBefore=100)
468
+
469
+ :param imgPath:[必须参数]图片保存路径,如"d:/"
470
+ :param imgName:[必选参数]图片名称,如"test.png"
471
+ :param rect:[可选参数]截图的矩形范围,如:{"x": 0, "y": 0, "width": 200, "height": 200}。传递为 None 则截取整个标签页的显示区域。默认None
472
+ :param continueOnError:[可选参数]错误继续执行。默认False
473
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认300
474
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
475
+ :return:None
476
+ '''
477
+ @staticmethod
478
+ def SetAttribute(target: str | dict, attrname: str, value: str, onlyvis: bool = False, index: int = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
479
+ '''
480
+ 设置元素属性值
481
+
482
+ setResult = Web.SetAttribute(target, attrname, value, onlyvis=False, index=None, continueOnError=False, delayAfter=100, delayBefore=100)
483
+
484
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
485
+ :param attrname: [必选参数]属性名称。
486
+ :param value: [必选参数]属性值。
487
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
488
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
489
+ :param continueOnError: [可选参数]是否继续执行。默认False
490
+ :param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
491
+ :param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
492
+ :return: 设置成功返回True,否则返回False
493
+ '''
494
+ @staticmethod
495
+ def SetCheck(target: str | dict, onlyvis: bool = False, index: int = None, isCheck: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
496
+ '''
497
+ 设置元素勾选状态(radio或checkbox)
498
+
499
+ setResult = Web.SetCheck(target, onlyvis=False, index=None, isCheck=True, continueOnError=False, delayAfter=100, delayBefore=100)
500
+
501
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
502
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
503
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
504
+ :param isCheck: [可选参数]是否勾选。True:勾选,False:不勾选。默认True
505
+ :param continueOnError: [可选参数]是否继续执行。默认False
506
+ :param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
507
+ :param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
508
+ :return: 设置成功返回True,否则返回False
509
+ '''
510
+ @staticmethod
511
+ def SetFocus(target: str | dict, onlyvis: bool = False, index: int = None, setForeground: bool = True, checkElementShow: bool = True, focusMode: str = 'focus', delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
512
+ '''
513
+ 设置元素焦点
514
+
515
+ tdrpa_element_id = Web.SetFocus(target, onlyvis=False, index=None, setForeground=True, checkElementShow=True, focusMode=\'focus\', delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=100)
516
+
517
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
518
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
519
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
520
+ :param setForeground: [可选参数]是否将元素设置为前台窗口。默认True
521
+ :param checkElementShow: [可选参数]是否检查元素是否可见。默认True
522
+ :param focusMode: [可选参数]焦点模式。\'focus\':获得焦点。\'blur\':离开焦点。默认\'focus\'
523
+ :param delayTime: [可选参数]等待元素出现的超时时间(毫秒)。默认10000
524
+ :param continueOnError: [可选参数]是否继续执行。默认False
525
+ :param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
526
+ :param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
527
+ :return: tdrpa_element_id
528
+ '''
529
+ @staticmethod
530
+ def SetScroll(scrollPostion: dict, smooth: bool = True, waitTime: int = 2000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> dict | None:
531
+ '''
532
+ 设置滚动条位置(像素)
533
+
534
+ position = Web.SetScroll({"ScrollLeft": 0, "ScrollTop": 500}, smooth=True, waitTime=2000, continueOnError=False, delayAfter=100, delayBefore=100)
535
+
536
+ :param scrollPostion:[可选参数]滚动条位置。如:{"ScrollLeft": 0,"ScrollTop": 0}
537
+ :param smooth:[可选参数]是否平滑滚动。True:平滑滚动到指定位置。False:迅速滚动到指定位置。默认True
538
+ :param waitTime:[可选参数]等待多长时间(毫秒)后返回滚动条位置,不能超过5000(毫秒)。默认2000
539
+ :param continueOnError:[可选参数]错误继续执行。默认False
540
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
541
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
542
+ :return:返回当前页面的滚动条位置 如{\'ScrollLeft\': 0, \'ScrollTop\': 0},没有则返回None
543
+ '''
544
+ @staticmethod
545
+ def SetSelect(target: str | dict, selected: str | list | int, onlyvis: bool = False, index: int = None, selectMode: str = 'text', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
546
+ '''
547
+ 设置元素选中项(select)
548
+
549
+ Web.SetSelect(target, selected, onlyvis=False, index=None, selectMode="text", continueOnError=False, delayAfter=100, delayBefore=100)
550
+
551
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
552
+ :param selected: [必选参数]选中的值。str类型时:选中的值。list类型时:选中的值列表。int类型时:选中的值索引。
553
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
554
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
555
+ :param selectMode: [可选参数]设置选中项的模式。\'index\':根据索引选中。\'value\':根据值选中。\'text\':根据文本选中。默认\'text\'
556
+ :param continueOnError: [可选参数]是否继续执行。默认False
557
+ :param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
558
+ :param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
559
+ :return: None
560
+ '''
561
+ @staticmethod
562
+ def SetValue(target: str | dict, onlyvis: bool = False, index: int = None, value: str = '', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
563
+ '''
564
+ 设置元素的值
565
+
566
+ setResult = Web.SetValue(target, onlyvis=False, index=None, value=\'\', continueOnError=False, delayAfter=100, delayBefore=100)
567
+
568
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
569
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
570
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
571
+ :param value: [可选参数]要设置的值。默认\'\'
572
+ :param continueOnError: [可选参数]是否继续执行。默认False
573
+ :param delayAfter: [可选参数]执行步骤后等待的时间(毫秒)。默认值为 100。
574
+ :param delayBefore: [可选参数]执行步骤前等待的时间(毫秒)。默认值为 100。
575
+ :return: 返回设置完成的值
576
+ '''
577
+ @staticmethod
578
+ def Stop(delayTime: int = 10000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 1000) -> bool | None:
139
579
  """
140
- 绑定浏览器
580
+ 停止网页加载
141
581
 
142
- page = Web.PwStart()
582
+ stopResult = Web.Stop(delayTime=10000, continueOnError=False, delayAfter=100, delayBefore=1000)
143
583
 
144
- :return: firstPage
584
+ :param delayTime:[可选参数]超时时间(毫秒)。默认10000
585
+ :param continueOnError:[可选参数]错误继续执行。默认False
586
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
587
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认1000
588
+ :return:页面停止成功返回True,失败返回False
145
589
  """
146
590
  @staticmethod
147
- def OpenChrome(url: str = None, chromeExePath: str = None, isMaximize: bool = True, supportUia: bool = True, userData: Incomplete | None = None, otherStartupParam: Incomplete | None = None, env_variables: Incomplete | None = None, delayTime: int = 30000) -> None:
591
+ def SwitchTab(matchTabContent: str = '', matchTabType: str = 'title', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool | None:
148
592
  '''
149
- 启动谷歌浏览器
593
+ 切换浏览器标签页(可通过地址栏、标题栏进行匹配,支持包含匹配)
150
594
 
151
- Web.OpenChrome(url="www.baidu.com", chromeExePath=None, isMaximize=True, supportUia=True, userData=None, otherStartupParam=None, env_variables=None, delayTime=30000)
595
+ switchResult = Web.SwitchTab(\'百度\', matchTabType=\'title\', continueOnError=False, delayAfter=100, delayBefore=100)
152
596
 
153
- :param url:[可选参数]启动浏览器后打开的链接,字符串类型。默认None
154
- :param chromeExePath:[可选参数]谷歌浏览器可执行程序的绝对路径,字符串类型,填写None时会自动寻找本地安装的路径。默认None
155
- :param isMaximize:[可选参数]浏览器启动后是否最大化显示,选择True时最大化启动,选择False默认状态。默认True
156
- :param supportUia:[可选参数]是否支持uiautomatin,True支持,False不支持。默认True
157
- :param userData:[可选参数]浏览器用户数据存放位置
158
- :param otherStartupParam:[可选参数]其他启动谷歌浏览器的参数,如:[\'--xxx\', \'--xxx\']。默认None
159
- :param env_variables:[可选参数]启动浏览器进程时附带的环境变量,如{"a": "abc"}
160
- :param delayTime: 浏览器进程加载超时(毫秒)。默认30000
161
- :return:None
597
+ matchTabContent: [必选参数]标签页匹配的内容,标题支持包含匹配,例如“百度”,链接支持包含完整域名匹配,例如“baidu.com”
598
+ :param matchTabType:[可选参数]标签页匹配的类型,\'title\':匹配标题。\'url\':匹配链接。默认"title"
599
+ :param continueOnError:[可选参数]错误继续执行。默认False
600
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
601
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
602
+ :return: 切换成功返回True,失败返回False
162
603
  '''
163
604
  @staticmethod
164
- def ChromeProcessStatus() -> bool:
605
+ def SetWindowState(ChromeWinState: str = 'topmost', continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> None:
165
606
  """
166
- 检查启动的Chrome浏览器进程是否正在运行
607
+ 设置浏览器窗口状态
167
608
 
168
- chromeStatus = Web.ChromeProcessStatus()
609
+ Web.SetWindowState(ChromeWinState='topmost', continueOnError=False, delayAfter=100, delayBefore=100)
169
610
 
170
- :return:返回True时,表示浏览器仍在运行,返回False时,表示浏览器非运行状态
611
+ :param ChromeWinState:[可选参数]浏览器窗口状态。'activate': 激活。'topmost':置顶并激活。'untop':取消置顶并移到底层显示。默认'topmost'
612
+ :param continueOnError:[可选参数]错误继续执行。默认False
613
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
614
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
615
+ :return:None
171
616
  """
172
617
  @staticmethod
173
- def TopMost() -> None:
618
+ def WaitElement(target: str | dict, onlyvis: bool = False, index: int = None, waitType: str = 'show', delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> str | None:
619
+ '''
620
+ 等待元素
621
+
622
+ tdrpa_element_id = Web.WaitElement(target, onlyvis=False, index=None, waitType=\'show\', delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
623
+
624
+ :param target: [必选参数]网页元素特征码。str类型时:css选择器,或xpath,或tdrpa_element_id。dict类型时:{"selector":css选择器, "txt": 网页元素上的文字}
625
+ :param onlyvis: [可选参数]仅匹配可见元素。默认False
626
+ :param index: [可选参数]元素索引。None:忽略索引,int:索引为整数时,从1开始算索引。 target为tdrpa_element_id时会自动忽略此参数。默认None
627
+ :param waitType: [可选参数]等待元素方式。\'show\':等待元素出现。\'hide\':等待元素消失。默认\'show\'
628
+ :param delayTime:[可选参数]超时时间(毫秒)。默认60000
629
+ :param continueOnError:[可选参数]错误继续执行。默认False
630
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
631
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
632
+ :return:tdrpa_element_id
633
+ '''
634
+ @staticmethod
635
+ def WaitPage(delayTime: int = 60000, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100):
174
636
  """
175
- 浏览器置顶
637
+ 等待网页加载完成
176
638
 
177
- Web.TopMost()
639
+ waitResult = Web.WaitPage(delayTime=60000, continueOnError=False, delayAfter=100, delayBefore=100)
178
640
 
641
+ :param delayTime:[可选参数]超时时间(毫秒)。默认60000
642
+ :param continueOnError:[可选参数]错误继续执行。默认False
643
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
644
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
645
+ :return:页面加载完成返回True,未加载完成返回False
179
646
  """
180
647
 
181
- class ChromePlugin:
648
+ class WebPW:
182
649
  @staticmethod
183
- def Open(url: str = None, clearChrome: bool = True, userData: str = None, otherStartupParam: list = None):
650
+ def GetActivePage(delayTime: int = 10000, continueOnError: bool = False) -> Page:
184
651
  """
185
- 启动新的浏览器
652
+ 获取当前激活的页面
186
653
 
187
- ChromePlugin.Open(url='www.baidu.com', clearChrome=True, userData=None, otherStartupParam=None)
654
+ page = WebPW.GetActivePage(delayTime=10000, continueOnError=False)
188
655
 
656
+ :param delayTime: 查找延时(豪秒)。默认10000
657
+ :param continueOnError: 错误继续执行。默认False
658
+ :return: Page
189
659
  """
190
660
  @staticmethod
191
- def JS(js_str: str, returnList: bool = False):
661
+ def FindWebElement(target: str, anchorsElement: ElementHandle = None, delayTime: int = 10000, continueOnError: bool = False, isVisible: bool = True) -> ElementHandle:
192
662
  """
193
- 执行JS注入
663
+ 查找元素
194
664
 
195
- ChromePlugin.JS(js_str, returnList=False)
665
+ eh = WebPW.FindWebElement(target, anchorsElement=None, delayTime=10000, continueOnError=False, isVisible=True)
196
666
 
667
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
668
+ :param anchorsElement:[可选参数]锚点元素,默认None
669
+ :param delayTime: 查找延时(豪秒)。默认10000
670
+ :param continueOnError: 错误继续执行。默认False
671
+ :param isVisible:检查是否可见。默认True
672
+ :return: ElementHandle
197
673
  """
198
674
  @staticmethod
199
- def Close(tryClose: int = 3, userData: str = None):
675
+ def Exists(target: str, anchorsElement: ElementHandle = None, isVisible: bool = True, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> bool:
676
+ """
677
+ 元素是否存在(不可见归于不存在)
678
+
679
+ WebPW.Exists(target, anchorsElement=None, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
680
+
681
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
682
+ :param anchorsElement:[可选参数]锚点元素,默认None
683
+ :param isVisible:[可选参数]检查是否可见。默认True
684
+ :param continueOnError:[可选参数]错误继续执行。默认False
685
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
686
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
687
+ :return:存在返回True,不存在返回False
688
+ """
689
+ @staticmethod
690
+ 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:
691
+ '''
692
+ 等待元素加载
693
+
694
+ WebPW.Wait(target, anchorsElement=None, waitType="show", delayTime=30000, isVisible=True, continueOnError=False, delayAfter=100, delayBefore=100)
695
+
696
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串
697
+ :param anchorsElement:[可选参数]锚点元素,默认None
698
+ :param waitType:[可选参数]等待方式。 等待显示:"show" 等待消失:"hide"。默认"show"
699
+ :param delayTime:[可选参数]等待最大时间。默认30000毫秒(30秒)
700
+ :param isVisible:[可选参数]检查是否可见。默认True
701
+ :param continueOnError:[可选参数]错误继续执行。默认False
702
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
703
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
704
+ :return:None
705
+ '''
706
+ @staticmethod
707
+ def GetParentElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
200
708
  """
201
- 关闭chrome
709
+ 获取父级元素
202
710
 
203
- ChromePlugin.Close(tryClose=3, userData=None)
711
+ eh = WebPW.GetParentElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
204
712
 
713
+ :param eh:[必选参数]ElementHandle
714
+ :param continueOnError:[可选参数]错误继续执行。默认False
715
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
716
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
717
+ :return:ElementHandle
205
718
  """
206
719
  @staticmethod
207
- def WaitLoading(delayTime: int = 60000) -> None:
720
+ def GetNextSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
208
721
  """
209
- 等待加载
722
+ 获取下一个兄弟元素
210
723
 
211
- ChromePlugin.WaitLoading(delayTime=60000)
724
+ eh = WebPW.GetNextSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
212
725
 
726
+ :param eh:[必选参数]ElementHandle
727
+ :param continueOnError:[可选参数]错误继续执行。默认False
728
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
729
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
730
+ :return:ElementHandle
213
731
  """
214
732
  @staticmethod
215
- def Reload() -> None:
733
+ def GetPreviousSiblingElement(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
216
734
  """
217
- 刷新页面
735
+ 获取前一个兄弟元素
218
736
 
219
- ChromePlugin.Reload()
737
+ eh = WebPW.GetPreviousSiblingElement(eh, continueOnError=False, delayAfter=100, delayBefore=100)
220
738
 
739
+ :param eh:[必选参数]ElementHandle
740
+ :param continueOnError:[可选参数]错误继续执行。默认False
741
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
742
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
743
+ :return:ElementHandle
221
744
  """
222
745
  @staticmethod
223
- def GoUrl(url, isWaitLoading: bool = True, delayTime: int = 60000) -> None:
746
+ def GetChildrenElements(eh: ElementHandle, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100) -> list | None:
224
747
  """
225
- 跳转页面
748
+ 获取子节点
226
749
 
227
- ChromePlugin.GoUrl('www.baidu.com', isWaitLoading=True, delayTime=60000)
750
+ ehList = WebPW.GetChildrenElements(eh, continueOnError=False, delayAfter=100, delayBefore=100)
228
751
 
752
+ :param eh:[必选参数]ElementHandle
753
+ :param continueOnError:[可选参数]错误继续执行。默认False
754
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
755
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
756
+ :return: list[ElementHandle, ElementHandle,...]
229
757
  """
758
+ @staticmethod
759
+ 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:
760
+ '''
761
+ 点击元素
762
+
763
+ eh = WebPW.Click(target, button="left", clickType="click", anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
764
+
765
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
766
+ :param button:[可选参数]鼠标按键。left:左键,right:右键,middle:中键。默认left
767
+ :param clickType:[可选参数]点击方式。click 单击,dblclick 双击。默认click
768
+ :param anchorsElement:[可选参数]锚点元素,默认None
769
+ :param continueOnError:[可选参数]错误继续执行。默认False
770
+ :param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
771
+ :param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
772
+ :param delayTime:超时(豪秒)。默认10000
773
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
774
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
775
+ :return: ElementHandle
776
+ '''
777
+ @staticmethod
778
+ 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:
779
+ '''
780
+ 鼠标悬停在元素上
781
+
782
+ eh = WebPW.Hover(target, anchorsElement=None, continueOnError=False, position=None, keyModifiers=None, delayTime=10000, delayAfter=100, delayBefore=100)
783
+
784
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
785
+ :param anchorsElement:[可选参数]锚点元素,默认None
786
+ :param continueOnError:[可选参数]错误继续执行。默认False
787
+ :param position:以元素左上角偏移量{\'x\': 0, \'y\': 0},None时点击中心
788
+ :param keyModifiers:[可选参数]辅助按键["Alt", "Ctrl", "Shift"]可多选。默认None
789
+ :param delayTime:超时(豪秒)。默认10000
790
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
791
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
792
+ :return: ElementHandle
793
+ '''
794
+ @staticmethod
795
+ def Input(text: str, target: str | ElementHandle, anchorsElement: ElementHandle = None, continueOnError: bool = False, delayTime: int = 10000, delayAfter: int = 100, delayBefore: int = 100) -> ElementHandle | None:
796
+ """
797
+ 输入文本
798
+
799
+ eh = WebPW.Input(text, target, anchorsElement=None, continueOnError=False, delayTime=10000, delayAfter=100, delayBefore=100)
800
+
801
+ :param text:[必选参数]文本内容
802
+ :param target:[必选参数]tdRPA拾取器获取的目标元素特征字符串 或 ElementHandle
803
+ :param anchorsElement:[可选参数]锚点元素,默认None
804
+ :param continueOnError:[可选参数]错误继续执行。默认False
805
+ :param delayTime:超时(豪秒)。默认10000
806
+ :param delayAfter:[可选参数]执行后延时(毫秒)。默认100
807
+ :param delayBefore:[可选参数]执行前延时(毫秒)。默认100
808
+ :return: ElementHandle
809
+ """
tdrpa/tdworker/_winE.pyi CHANGED
@@ -9,7 +9,7 @@ class WinElement:
9
9
  WinElement.FindElementByTd('', anchorsElement=None, searchDelay=10000, continueOnError=False)
10
10
 
11
11
  :param tdTargetStr: 目标元素特征码(tdrpa拾取器获取)
12
- :param anchorsElement: 从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)
12
+ :param anchorsElement: 从哪个元素开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
13
13
  :param searchDelay: 查找延时(豪秒)。默认10000
14
14
  :param continueOnError: 错误继续执行。默认False
15
15
  :return: 目标元素 or None
@@ -153,7 +153,7 @@ class WinElement:
153
153
  WinElement.GetValue(target, getMethod="auto", searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100)
154
154
 
155
155
  :param target: [必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
156
- :param getMethod: [可选参数]获取方式。自动方式:"auto" 获得元素Name方式:"name" 获得元素Value方式:"value"。默认"auto"
156
+ :param getMethod: [可选参数]获取方式。自动方式:"auto" 获得元素Name方式:"name" 获得元素Value方式:"value" 获得元素Text方式:"text"。默认"auto"
157
157
  :param searchDelay: [可选参数]超时时间(毫秒)。默认10000
158
158
  :param anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
159
159
  :param continueOnError: [可选参数]错误继续执行。默认False
@@ -225,22 +225,4 @@ class WinElement:
225
225
  :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
226
226
  :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
227
227
  :return: None
228
- '''
229
-
230
- # class WinText:
231
- # @staticmethod
232
- # def GetText(target: str | uia.Control, searchDelay: int = 10000, anchorsElement: uia.Control = None, continueOnError: bool = False, delayAfter: int = 100, delayBefore: int = 100, setForeground: bool = True):
233
- # """
234
- # 获取文本内容
235
-
236
- # WinText.GetText(target, searchDelay=10000, anchorsElement=None, continueOnError=False, delayAfter=100, delayBefore=100, setForeground=True)
237
-
238
- # :param target: [必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
239
- # :param searchDelay: [可选参数]超时时间(毫秒)。默认10000
240
- # :param anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
241
- # :param continueOnError: [可选参数]错误继续执行。默认False
242
- # :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
243
- # :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
244
- # :param setForeground: [可选参数]激活窗口。默认True
245
- # :return: 文本内容
246
- # """
228
+ '''
tdrpa/tdworker/_winM.pyi CHANGED
@@ -10,7 +10,7 @@ class WinMouse:
10
10
 
11
11
  :param target: [必选参数]tdRPA拾取器获取的目标元素特征字符串或uia目标元素对象
12
12
  :param button: [可选参数]鼠标点击。鼠标左键:"left" 鼠标右键:"right" 鼠标中键:"middle"。默认"left"
13
- :param clickType: [可选参数]点击类型。单击:"click" 双击:"dbclick" 按下:"down" 弹起:"up"。默认"click"
13
+ :param clickType: [可选参数]点击类型。单击:"click" 双击:"dblclick" 按下:"down" 弹起:"up"。默认"click"
14
14
  :param searchDelay: [可选参数]超时时间(毫秒)。默认10000
15
15
  :param anchorsElement: [可选参数]锚点元素,从它开始找,不传则从桌面顶级元素开始找(有值可提高查找速度)。默认None
16
16
  :param continueOnError: [可选参数]错误继续执行。默认False
@@ -55,7 +55,7 @@ class WinMouse:
55
55
  WinMouse.Click(button="left", clickType="click", keyModifiers=None, delayAfter=100, delayBefore=100)
56
56
 
57
57
  :param button: [可选参数]鼠标点击。鼠标左键:"left" 鼠标右键:"right" 鼠标中键:"middle"。默认"left"
58
- :param clickType: [可选参数]点击类型。单击:"click" 双击:"dbclick" 按下:"down" 弹起:"up"。默认"click"
58
+ :param clickType: [可选参数]点击类型。单击:"click" 双击:"dblclick" 按下:"down" 弹起:"up"。默认"click"
59
59
  :param keyModifiers: [可选参数]辅助按键["Alt","Ctrl","Shift","Win"]可多选。默认None
60
60
  :param delayAfter: [可选参数]执行后延时(毫秒)。默认100
61
61
  :param delayBefore: [可选参数]执行前延时(毫秒)。默认100
Binary file
@@ -1,12 +1,12 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: tdrpa.tdworker
3
- Version: 1.1.10.3
3
+ Version: 1.2.11.1
4
4
  Summary: tdworker for tdrpa developers. supports python3.8+, windows x64
5
5
  Home-page: https://gitee.com/tdworker/command/wikis/pages
6
6
  Author: vx:RPA_CREATOR
7
7
  Author-email: virtualpartner@qq.com
8
8
  License: Apache 2.0
9
- Keywords: rpa,RPA,tdRPA,tdworker,rpaworker,worker,uiautomation,uia,creator,windows,python,bot,robot,aigc,ai,按键精灵
9
+ Keywords: rpa,RPA,tdRPA,tdworker,rpaworker,worker,uiautomation,uia,creator,windows,python,bot,robot,aigc,ai,xpath,按键精灵,办公自动化,影刀,UIBOT,实在智能
10
10
  Platform: Windows Only
11
11
  Classifier: Programming Language :: Python :: 3
12
12
  Classifier: Operating System :: Microsoft :: Windows
@@ -1,4 +1,4 @@
1
- tdrpa/tdworker.cp311-win_amd64.pyd,sha256=U1wrkFrrGR1pPYDis-GF5b6f7Rfkq8D4mcW6QRvCEQc,3418624
1
+ tdrpa/tdworker.cp311-win_amd64.pyd,sha256=9sOkdndu37h5KkZCl-onMNu4-5xa5KnHimFID-5wbU0,5273088
2
2
  tdrpa/_tdxlwings/__init__.py,sha256=mxmqGWQ7xFb6e1GqkKEBfMQtZ8YyO4kAcPOvcJnD_2k,4424
3
3
  tdrpa/_tdxlwings/_win32patch.py,sha256=_IxTfvj663osTXh8b1S-A_N4PthS9gEWFLjpY4V0iUA,3443
4
4
  tdrpa/_tdxlwings/_xlmac.py,sha256=23OusKchbqglFi1s909tbB9fIwoFj6Yny4GiYrsnx5s,68521
@@ -82,18 +82,18 @@ tdrpa/_tdxlwings/quickstart_fastapi/requirements.txt,sha256=y3pL1maFFVyROPGnd2YD
82
82
  tdrpa/_tdxlwings/rest/__init__.py,sha256=Dk7m0qKA9yIswBm_66Vw1MHmiiYRmqZ3egAUIMjUjts,41
83
83
  tdrpa/_tdxlwings/rest/api.py,sha256=yfv1VkTpjQOzxLh4aMnZQsh8wTRHg34KkyipKDa_w4g,12885
84
84
  tdrpa/_tdxlwings/rest/serializers.py,sha256=ztMzL_EgbhAb3rSbfWFE2A9uyOykoZbkSoDHPeKXzGg,2885
85
- tdrpa/tdworker/__init__.pyi,sha256=UjQLwfulzOjeFwgR9y5GQFf6I08XPWFy0a220XCFA_E,416
85
+ tdrpa/tdworker/__init__.pyi,sha256=H5602jkV_k7msPClhkpuJxrLK7Hx2QubeoyqGI5LkYk,402
86
86
  tdrpa/tdworker/_clip.pyi,sha256=Y0FB0DHj8lLPC6uhfc8BOjpyfvhBZagrcm4hha7f_ss,1381
87
87
  tdrpa/tdworker/_excel.pyi,sha256=Kc684QBhV4p2lvj9y1K5Kmo2r0t492BzGN7Q5DRGVR4,61904
88
- tdrpa/tdworker/_img.pyi,sha256=PydH_-GkBskGWE4ZA39dzL9qBaELNIhz7z95DPXTjck,25542
88
+ tdrpa/tdworker/_img.pyi,sha256=f1FZQYHSItcjbtQ09LrXrD7IzUXWpOfe7Tu-J-9heuk,26375
89
89
  tdrpa/tdworker/_os.pyi,sha256=cK2UJk6pM8piWA2Mkx3j1v0i5vYlttaiGvm62yaPhzc,2274
90
90
  tdrpa/tdworker/_sp.pyi,sha256=OwKyMzbxhTvjXcHBx-w_6et1hdlJTPyHMpC8DHjWW4Q,635
91
91
  tdrpa/tdworker/_w.pyi,sha256=ZwyIk5cLv8Rd0KpshdZSJ9EIN0XYMHYCARw31pvrzys,5229
92
- tdrpa/tdworker/_web.pyi,sha256=aVjdY9P4_FBGEklru9V6gZ2CVMu5dyO1ScKaW-AkX3s,8442
93
- tdrpa/tdworker/_winE.pyi,sha256=3EjsBX3ryah9vYSmilseM75mYzqM7jsYcPd-Tzz8cM0,18696
92
+ tdrpa/tdworker/_web.pyi,sha256=kmV3YrdAeN1-WhOLfqnFCoq-L8Mp3_N7Hhqn7z5e6lg,60484
93
+ tdrpa/tdworker/_winE.pyi,sha256=s5IHyB4zLyshyvcPEEjaY-Vdyy02E1fnECASzXUsFZY,17557
94
94
  tdrpa/tdworker/_winK.pyi,sha256=lH1_smTsfHQVDaREOy37cb1Ied8zlKo6Q20oc1GXBGc,5407
95
- tdrpa/tdworker/_winM.pyi,sha256=EeaY667JbYHNL7mTE2-pHSA-PMFB5hbu1Mz4Vjq1Q14,7936
96
- tdrpa.tdworker-1.1.10.3.dist-info/METADATA,sha256=Jwohf8nWXM2WPLwTl5ch1KZlpFXrBn5g9gpRSVrwH04,922
97
- tdrpa.tdworker-1.1.10.3.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
98
- tdrpa.tdworker-1.1.10.3.dist-info/top_level.txt,sha256=S9UoqmC_cyGqKbGsBkLQPEeQLbDrWD0SRwbxPpQpyyU,6
99
- tdrpa.tdworker-1.1.10.3.dist-info/RECORD,,
95
+ tdrpa/tdworker/_winM.pyi,sha256=E_PJm6cLgpkqy7fcD6CMNlSS31xVmE1N31DP1Cj47yI,7938
96
+ tdrpa.tdworker-1.2.11.1.dist-info/METADATA,sha256=Dd7f9-85VAYCcZyne7c7phANEOG5bGHkMlLAy9rYEmY,970
97
+ tdrpa.tdworker-1.2.11.1.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
98
+ tdrpa.tdworker-1.2.11.1.dist-info/top_level.txt,sha256=S9UoqmC_cyGqKbGsBkLQPEeQLbDrWD0SRwbxPpQpyyU,6
99
+ tdrpa.tdworker-1.2.11.1.dist-info/RECORD,,