跳到主要内容

自动化动作白名单

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