F(x)

create(url, wait=True, timeout=100, chrome_path=None)

方法描述

创建chrome对象

参数说明

url<str>要打开的url

wait<bool>是否等待加载完成

timeout<int>等待超时时间, 默认100s

chrome_path<str>chrome.exe路径, 默认查找%ProgramFiles%, %ProgramFiles(x86)%

返回值说明

返回ChromeTab对象<ChromeTab>

调用样例- rpa.app.chrome.create-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 代码调用样例如下：
page = rpa.app.chrome.create('www.aliyun.com')

catch(name, mode='title', pattern='contain', timeout=10)

方法描述

捕获已打开的页面

参数说明

name<str>标题或者url

mode<str>页面匹配类型

可选项：

• title : 标题

• url : url

pattern<str>页面匹配模式

可选项：

• equal : 完全匹配

• contain : 包含匹配

• regular : 正则表达式匹配

返回值说明

返回Browser对象<ChromeTab>

调用样例- rpa.app.chrome.catch-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件，使用前需要先确认对应网页已打开
# 代码调用样例如下：
page = rpa.app.chrome.catch('阿里云')

catch_specific_pages(name, mode='title', pattern='contain')

方法描述

捕获满足条件的所有页面

参数说明

name<str>标题或者url

mode<str>页面匹配类型

可选项：

• title : 标题

• url : url

pattern<str>页面匹配模式

可选项：

• equal : 完全匹配

• contain : 包含匹配

• regular : 正则表达式匹配

返回值说明

返回Browser对象的列表<list>

调用样例- rpa.app.chrome.catch_specific_pages-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件，使用此方法前需确认至少已打开一个符合条件的网页
# 代码调用样例如下：
page_list = rpa.app.chrome.catch_specific_pages('阿里云')

catch_all_pages()

方法描述

返回所有的页面

调用样例- rpa.app.chrome.catch_all_pages-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 代码调用样例如下：
page_list = rpa.app.chrome.catch_all_pages()

catch_activated_pages()

方法描述

返回所有激活的页面

调用样例- rpa.app.chrome.catch_activated_pages-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 当开启多个chrome浏览器程序，每个chrome程序上有多个Tab页签的情况下，可使用此方法返回每一个chrome程序中处于激活状态的Tab网页
# 代码调用样例如下：
page_list = rpa.app.chrome.catch_activated_pages()

close_all()

方法描述

关闭所有的页面

调用样例- rpa.app.chrome.close_all-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 代码调用样例如下：
rpa.app.chrome.close_all()

maximize()

方法描述

最大化浏览器窗口

调用样例- rpa.app.chrome.maximize-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 在开启多个chrome程序窗口的情况下，此方法只会将其中一个窗口最大化
# 代码调用样例如下：
rpa.app.chrome.maximize()

minimize()

方法描述

最小化浏览器窗口

调用样例- rpa.app.chrome.minimize-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 在开启多个chrome程序窗口的情况下，此方法只会将其中一个窗口最小化
# 代码调用样例如下：
rpa.app.chrome.minimize()

restore()

方法描述

还原浏览器窗口

调用样例- rpa.app.chrome.restore-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 在开启多个chrome程序窗口的情况下，此方法只会将其中一个窗口还原
# 代码调用样例如下：
rpa.app.chrome.restore()

catch_from_element_name(element)

方法描述

通过元素名称捕获页面

参数说明

element<str>元素名称

返回值说明

ChromeTab对象

调用样例- rpa.app.chrome.catch_from_element_name-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 代码调用样例如下：
page = rpa.app.chrome.catch_from_element_name('百度输入框')
page.input_text('百度输入框','阿里云')

get_cookies(url=None, domain=None, name=None)

方法描述

获取一组cookie

参数说明

url<str>将检索到的cookie限制为与给定URL匹配的cookie

domain<str>将检索到的cookie限制为域匹配或属于该域的子域的cookie

name<str>按名称过滤cookie

返回值说明

返回当前网站下的所有cookie<list>

调用样例- rpa.app.chrome.get_cookies-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# url参数需要使用带协议的完整写法
# 代码调用样例如下：
cookies = rpa.app.chrome.get_cookies(url='https://www.aliyun.com')

remove_cookie(url, name)

方法描述

删除cookie

参数说明

url<str>与cookie关联的URL

name<str>要删除的cookie的名称

调用样例- rpa.app.chrome.remove_cookie-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# url参数需要使用带协议的完整写法
# 代码调用样例如下：
rpa.app.chrome.remove_cookie('https://www.baidu.com','domain')

set_cookie(url, name, domain=None, value=None, path=None, secure=False, http_only=False, expiration_date=None)

方法描述

设置cookie

参数说明

url<str>与cookie设置相关联的request-URI

name<str>cookie的名称

domain<str>cookie的域。如果省略，则cookie变为host-only的cookie

value<str>cookie的值。如果省略，默认为空

path<str>cookie的路径。默认为url参数的路径部分

secure<bool>cookie是否应标记为secure

http_only<bool>cookie是否应标记为http_only

expiration_date<str>cookie的到期日期

调用样例- rpa.app.chrome.set_cookie-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# url参数需要使用带协议的完整写法
# 代码调用样例如下：
rpa.app.chrome.set_cookie('https://www.baidu.com','rpa_test',value='阿里云RPA测试_www.aliyun.com')

network_capture_stop(capture_key)

方法描述

停止网页请求监听

参数说明

capture_key<str>网页请求监听索引

返回值说明

无

调用样例- rpa.app.chrome.network_capture_stop-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 此方法需要基于ChromeTab实例对象进行操作
# 代码调用样例如下：
# 打开谷歌浏览器阿里云页面
page = rpa.app.chrome.create('www.aliyun.com')
# 开始网页请求监听
capture_key = page.network_capture_start(url='', use_regular=False, capture_types=[])
# 刷新页面
page.reload()
# 获取网页请求监听结果
web_respond_body = rpa.app.chrome.get_network_capture_result(capture_key)
# 停止网页请求监听
rpa.app.chrome.network_capture_stop(capture_key)
# 记录信息日志
rpa.console.logger.info(web_respond_body)

get_network_capture_result(capture_key)

方法描述

获取网页请求监听结果

参数说明

capture_key<str>网页请求监听索引

返回值说明

网页请求监听结果json字符串<string>

调用样例- rpa.app.chrome.get_network_capture_result-

# 注意事项：此方法需要确认已安装并启用Aliyun RPA对应的chrome扩展插件
# 此方法需要基于ChromeTab实例对象进行操作
# 代码调用样例如下：
# 打开谷歌浏览器阿里云页面
page = rpa.app.chrome.create('www.aliyun.com')
# 开始网页请求监听
capture_key = page.network_capture_start(url='', use_regular=False, capture_types=[])
# 刷新页面
page.reload()
# 获取网页请求监听结果
web_respond_body = rpa.app.chrome.get_network_capture_result(capture_key)
# 停止网页请求监听
rpa.app.chrome.network_capture_stop(capture_key)
# 记录信息日志
rpa.console.logger.info(web_respond_body)