全部产品
云市场

rpa.chrome

更新时间:2020-03-23 16:40:21

目录

chrome

要使用chrome模块,需要rpa.chrome

chrome模块是用来向用户提供一系列操作内置浏览器的SDK,让用户通过简单的参数和方法调用来实现一些复杂的操作。

max_window

方法名
max_window()

方法描述
该方法会创建一个Browser对象,并将浏览器最大化。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. rpa.chrome.max_window()

create

方法名
create(url, *, wait=True, timeout=100)

方法描述
该方法会创建一个Browser对象,并将浏览器打开对应的页面。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • url : 要打开的url
  • wait : 是否等待加载完成
  • timeout : 等待超时时间

返回值说明
返回一个Browser类型的对象
示例

  1. page = rpa.chrome.create('www.baidu.com')

catch

方法名
catch(url, *, wait=True, timeout=100)

方法描述
该方法会捕获一个已经打开的页面,并返回一个Browser类型的对象。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • name : 标题或者url
  • mode : ‘title’|’url’

返回值说明
返回一个Browser类型的对象
示例

  1. page = rpa.chrome.catch('www.baidu.com', mode="url")

closeall

方法名
closeall()

方法描述
关闭所有的页面。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. rpa.chrome.closeall()

方法名
clean_cookie()

方法描述
该方法会清除所有页面cookie。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. rpa.chrome.clean_cookie()

Browser

Browser : 负责为用户提供Browser相关的一些操作。

close

方法名
close(self)

方法描述
该方法会关闭浏览器对象。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. page.close()

navigate

方法名
navigate(self, url, *, wait=True, timeout=100)

方法描述
该方法会从当前浏览器对象的链接跳转到另指定的链接。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • url : 要打开的url
  • wait : 是否等待加载完成
  • timeout : 等待超时时间

返回值说明

示例

  1. page.navigate('www.taobao.com')

back

方法名
back(self)

方法描述
该方法会浏览器后退。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. page.back()

activate

方法名
activate(self)

方法描述
该方法会浏览器切换。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. page.activate()

wait

方法名
wait(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会等待控件加载。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.wait('控件名称')

wait_disappear

方法名
wait_disappear(self, element, *, index=1, parent_element=None,timeout=10)

方法描述
该方法会等待控件消失。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.wait_disappear('控件名称')

download

方法名
download(self, *, path=None, element=None, url=None, name=None, index=1,parent_element=None, timeout=10)

方法描述
下载
调用浏览器下载方法,需要使用path,url,name(可空)
调用控件下载,需要用element,name,index(可空),parent_element(可空)
注:点按钮下载写的是name,用url下载写的是path

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • path : 保存的文件路径
  • url : 下载路径
  • name : 保存的文件名称(调用控件下载的时候可以是路径加名称
  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.download(path=r'D:/',url=r'http://pcr1.pc6.com/rm/bdbizhi.zip')
  2. page.download(element ='控件名称',name =r'aaa.zip')
  3. #遇到未产生空白页的异步下载需要判断下载完成
  4. page.download(name=r"C:\test\temp.exe", element="链接_16547")#写一个临时文件名
  5. while True:
  6. if os.path.exists(r"C:\test\temp.exe"): #等待文件创建
  7. try:
  8. os.rename(r"C:\test\temp.exe",r"C:\test\target.exe") #下载完成后能完成重命名操作
  9. break
  10. except Exception as e: #由于正在下载所以被占用
  11. # print(e)
  12. sleep(1)
  13. else:
  14. sleep(1)

upload

方法名
upload(self, element, file, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会上传文件。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • file : 上传的文件路径
  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.upload('控件名称',r'D:/baidu.jpg')

paste

方法名
paste(self)

方法描述
该方法会粘贴到浏览器。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. page.paste()

executejs

方法名
executejs(self, code)

方法描述
该方法会执行js代码。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明
code : js代码

返回值说明

示例

  1. page.executejs("alert('aaa')")

table

方法名
table(self, value, type=’index’, rtrtype=’text’, parent_element=None)

方法描述
该方法会返回二维数组或html。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • value : 类型为index时是下标,否则为正则表达式
  • type : ‘index’|’text’|’html’
  • rtrtype : ‘text’|’html’返回类型文本或者html

返回值说明
返回二维数组或html
示例

  1. result = page.table(1,'index','html')
  2. result = page.table(1,'index','text')
  3. result = page.table('Month','text','html')
  4. result = page.table('Month','text','text')
  5. result = page.table('<table border="1">','html','html')
  6. result = page.table('<table border="1">','html','text')

scroll

方法名
scroll(self, height=0)

方法描述
该方法会滚动页面。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明
height : 设置则滚动指定高度,否则滚动一屏幕

返回值说明

示例

  1. page.scroll()
  2. page.scroll(height=100)

text

text(self, element=None, *, index=1, parent_element=None)

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象

获取文本
方法名
text(self, element=None, *, index=1, parent_element=None)

方法描述
该方法会获取文本。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明
返回文本
示例

  1. result = page.text('控件名称')

html

方法名
html()

方法描述
该方法会获取html。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象

返回值说明
返回html
示例

  1. result = page.html('控件名称')

input

方法名
input(self,element,value,*,index=1,parent_element=None,simulate=True,timeout=10)

方法描述
该方法会输入框输入。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称(输入控件)
  • value : 输入的内容
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • simulate:是否模拟输入
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.input('控件名称','aaa')

value

方法名
value(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会获取value属性的值。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回value属性的值

示例

  1. result = page.value('控件名称')

option

方法名
option(self, element, value, *, index=1, parent_element=None,type=’match’, timeout=10)

方法描述
下拉框选择

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称(下拉列表控件)
  • value : 选择内容
  • index : 如果有多个,给出控件下标
  • type : ‘match’|’full’|’regex’ 分表标识模糊匹配|完全匹配|正则匹配
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. page.option('控件名称','Sa')
  2. page.option('控件名称','Sa',type='match')
  3. page.option('控件名称','Saab',type='full')
  4. page.option('控件名称','.*',type='regx')

check

方法名
check(self, element, *, value=None, index=1, parent_element=None,timeout=10)

方法描述
勾选框操作
获取勾选状态时有返回值

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称(复选框控件)
  • value : 不给获取勾选状态,传入True则勾选,传入False取消勾选
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回勾选状态时的值
示例

  1. result = page.check('控件名称')
  2. page.check('控件名称',value=True)
  3. page.check('控件名称',value=False)

click

方法名
clean_cookie()

方法描述
点击

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • simulate:是否模拟点击
  • timeout : 等待超时时间

返回值说明

示例

  1. page.click('控件名称')

element_count

方法名
element_count(self, element, *, parent_element=None)

方法描述
该方法会获取控件个数。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • parent_elemet : 父控件对象

返回值说明
返回控件个数
示例

  1. result = page.element_count('控件名称')

attr

方法名
attr(self, element, attrname, *, index=1, parent_element=None,timeout=10)

方法描述
该方法会获取控件属性。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称(复选框控件)
  • attrname : ‘value’|’name’|’href’ 值|名称|链接
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回控件属性
示例

  1. result = page.attr('控件名称',attrname='value')
  2. result = page.attr('控件名称',attrname='name')
  3. result = page.attr('控件名称',attrname='href')

alert

方法名
alert(self, element, *, value=’ok’, index=1, parent_element=None,timeout=10)

方法描述
该方法会弹出框点击。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称(弹出窗按钮)
  • value : ‘yes’|’no’ 点确定或取消
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.alert('按钮名称',value='no')

pos

方法名
pos(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会获取控件坐标。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回坐标 json格式{x1:,y1:,x2:,y2}
示例

  1. result = json.loads(page.pos('百度一下'))
  2. x1 = int(float(result["x1"]))
  3. x2 = int(float(result["x2"]))
  4. y1 = int(float(result["y1"]))
  5. y2 = int(float(result["y2"]))

screenshot

方法名
screenshot(self, element, file, *, index=1, parent_element=None,timeout=10)

方法描述
该方法会获取控件截图。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • file : 保存的截图路径
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.screenshot('控件名称',r'D:\aaa.jpg')

isvisible

方法名
isvisible(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会获取控件是否可见。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回控件是否可见
示例

  1. result = page.isvisible('控件名称')

drag

方法名
drag(self, element, *, x=None, y=None, index=1, parent_element=None,timeout=10)

方法描述
该方法会将元素拖拽到指定的位置。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • x : x轴偏移量
  • y : y轴偏移量
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.drag('控件名称')

clear_input

方法名
clear_input(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会清空输入框。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.clear_input('控件名称')

mouse_move

方法名
mouse_move(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会将鼠标移入。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明

示例

  1. result = page.mouse_move('控件名称')

get_element

方法名
get_element(self, element, *, index=1, parent_element=None, timeout=10)

方法描述
该方法会获取控件对象。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • parent_elemet : 父控件对象
  • timeout : 等待超时时间

返回值说明
返回控件对象
示例

  1. element = page.get_element('控件名称')

url

方法名
url(self)

方法描述
该方法会返回当前页面url。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. url = page.url()

title

方法名
title(self)

方法描述
该方法会返回当前页面标题。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明
返回当前页面标题
示例

  1. title = page.title()

reload

方法名
reload(self)

方法描述
该方法会刷新页面。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明

示例

  1. page.reload()

方法名
get_cookie(self)

方法描述
该方法会获取当前页面cookie。

版本信息
该方法适用于从3.3.0至3.4.0版本。

参数说明

返回值说明
返回当前页面cookie
示例

  1. page.get_cookie()