菜单

启动浏览器V2

请升级至最新的补丁版本后使用。

基本信息
POST  /api/v2/browser-profile/start

接口描述:用于启动浏览器,需要指定环境ID,启动成功后可以获取浏览器debug接口用于执行selenium和puppeteer自动化。 Selenium需要使用到对应内核版本匹配的Webdriver。需更新到应用版本3.4.1以上,启动浏览器后可在返回值中拿到对应的Webdriver的路径。

请求参数

Body 非必需参数可以不传递,传参格式为JSON。

参数名称  类型 必需 默认值 示例 说明
profile_id text - h1yynkm 环境ID,创建环境成功后生成的唯一ID。
profile_no text - 123 环境编号,如果已传环境ID则优先使用环境ID。
launch_args list - ["--window-position=400,0","--blink-settings=imagesEnabled=false", "--disable-notifications"] 启动参数,使用API时,如果API传了“launch_args”,则以API传的值为准。
headless text 0 0 设置是否启动headless浏览器,1:是;0:否(默认)。
last_opened_tabs text 1 1 设置是否继续浏览上次打开的标签页,1:是(默认);0:否。
proxy_detection text 1 1 设置是否打开检测页面,1:是(默认);0:否。
password_filling text 0 0 设置是否启用填充账密功能,1:是;0:否(默认)。仅首次打开环境时生效。
password_saving text 0 0 设置是否允许保存密码,1:是;0:否(默认)。仅Chrome内核生效。
cdp_mask text 1 1 设置是否屏蔽CDP检测,1:是(默认);0:否。iOS 和 Android 端强制开启。
delete_cache text 0 0 设置是否在关闭浏览器后清除缓存,1:是;0:否(默认)。若磁盘空间不足时,建议将该参数设置为1。
device_scale text - 1 设置手机模式下的缩放比,值范围0.1-2,填1就是100%。Chrome 128 内核 以上 且是 Android  和 iOS 才生效。

返回数据
// 执行成功
{
  "code":0,
  "data":{
    "ws":{
      "selenium":"127.0.0.1:xxxx",    //浏览器debug接口,可用于selenium自动化
      "puppeteer":"ws://127.0.0.1:xxxx/devtools/browser/xxxxxx"   //浏览器debug接口,可用于puppeteer自动化
    },
    "debug_port": "xxxx", // debug端口
    "webdriver": "C:\\xxxx\\chromedriver.exe" // webdriver路径
  },
  "msg":"success"
}

// 执行失败
{
  "code":-1,
  "data":{},
  "msg":"failed"
}

上一个
启动浏览器
下一个
关闭浏览器
最近修改: 2025-04-25Powered by