自动化动作白名单
POST /automation/sessions/:sessionId/actions 只接受下列动作,动作名不在白名单时返回 ACTION_NOT_ALLOWED。导航与交互类动作都可以额外传 params.snapshot(none、refs、full)控制回传快照的粒度,默认 refs。
captchaInspect
检测页面及各 iframe 中的验证码挑战并返回候选(含 frameIndex、frameUrl、challengeId),同时预装验证码回调钩子;grid 可传自定义图片网格的 DOM 选择器(root、tiles、instruction、verify、success、mode)。需带 X-Nex-Service-Context 请求头。
动作字段:grid
captchaRefresh
重新读取本会话已观察到的极验(GeeTest)参数接口,challengeUrl 必须是本会话内成功返回 JSON 的 GET 请求。需带 X-Nex-Service-Context 请求头。
动作字段:frameIndex / frameUrl / challengeId / challengeUrl
captchaApply
把识别答案 solution 回填到 captchaInspect 返回的挑战;frameIndex、frameUrl 必须与检测时一致。图片网格(productCode 为 GRID)按 solution.click 的格子序号点击,gridProgress=true 时只读取后续状态。需带 X-Nex-Service-Context 请求头。
动作字段:frameIndex / frameUrl / challengeId / solution / productCode / documentId / grid / gridProgress
navigate
动作专属字段:url;未写协议时自动补 https://(localhost 补 http://)。
动作字段:url
reload
无动作专属字段。
动作字段:无动作专属字段
goBack
无动作专属字段。
动作字段:无动作专属字段
goForward
无动作专属字段。
动作字段:无动作专属字段
wait
动作专属字段:target、text、time。
动作字段:target / text / time
snapshot
动作专属字段:target、depth、boxes、snapshot;snapshot 默认 full,传 refs 只返回元素引用段。
动作字段:target / depth / boxes / snapshot
title
无动作专属字段。
动作字段:无动作专属字段
url
无动作专属字段。
动作字段:无动作专属字段
text
动作专属字段:target。
动作字段:target
click
动作专属字段:target、button;也可传 x、y 按视口 CSS 像素点击(不能与 target 同时传,坐标须在视口内),此时可用 clickCount、delay。
动作字段:target / button / x / y / clickCount / delay
doubleClick
动作专属字段:target、button;坐标点击规则同 click。
动作字段:target / button / x / y / clickCount / delay
hover
动作专属字段:target。
动作字段:target
fill
动作专属字段:target、value。
动作字段:target / value
type
动作专属字段:target、text(兼容 value)、delay。
动作字段:target / text / delay
selectOption
动作专属字段:target、value、values。
动作字段:target / value / values
check
动作专属字段:target。
动作字段:target
uncheck
动作专属字段:target。
动作字段:target
drag
动作专属字段:startTarget、endTarget。
动作字段:startTarget / endTarget
press
动作专属字段:target、key。
动作字段:target / key
keyDown
动作专属字段:key。
动作字段:key
keyUp
动作专属字段:key。
动作字段:key
scroll
动作专属字段:target、deltaX、deltaY。
动作字段:target / deltaX / deltaY
screenshot
动作专属字段:type、filename、fullPage、quality、target、clip、scale;target、clip 与 fullPage=true 互斥,scale 取 css 或 device。返回截图区域与视口坐标的换算信息。
动作字段:type / filename / fullPage / quality / target / clip / scale
consoleMessages
动作专属字段:clear。
动作字段:clear
networkRequests
动作专属字段:clear、index。
动作字段:clear / index
dialogs
动作专属字段:id、accept、dismiss、promptText。
动作字段:id / accept / dismiss / promptText
uploadFiles
动作专属字段:target、files。
动作字段:target / files
evaluate
动作专属字段:code、expression;仅在 allowEvaluate 策略启用时可用,否则返回 ACTION_NOT_ALLOWED。
动作字段:code / expression
runCode
动作专属字段:code;仅在 allowRunCode 策略启用时可用,否则返回 ACTION_NOT_ALLOWED。
动作字段:code
resize
动作专属字段:width、height。
动作字段:width / height
drop
动作专属字段:target、files、data。
动作字段:target / files / data