ClickRow 使用说明
一句话:一个任务就是一串行(点击、输入、选择、勾选、等待……),ClickRow 在当前页面上按顺序执行,可以执行一轮或多轮。一切都在你的浏览器里完成。
1. 新建任务
- 点选元素:打开 ClickRow 弹窗,点「点选元素」,再到页面上点要操作的元素,每点一次加一行。
- 录制:点「录制」后正常操作页面,点击、输入、选择都会变成行。密码、卡号等只记成
{{ask}},不保存实际值。 - 识别表单:把本页表单的所有字段一次做成任务,可用随机测试数据或页面当前值。
- 模板:底栏「+」→「从模板新建…」。展开模板能看到每一行做什么,通用选择器在「高级」里;和你的页面对不上时,在编辑器里重新点选即可。
2. 运行、重复与停止
- 点任务右侧的圆形运行按钮。页面上会出现 ClickRow 浮动条,显示第几轮、第几行,可暂停、停止。
- 编辑器里的「重复」可以设置轮数、每轮间隔,或“直到某个元素消失”。
- 任务只在网址规则匹配的网站上运行;同一网站内翻页会接着跑,跳到别的网站会停止。
3. 取值:{{ask}}、计数与测试数据
{{ask}}:每次运行时询问你输入,值不会被保存。{{counter}}:当前轮次(1、2、3……),适合生成不重复的名称。- 测试数据如
{{fake:email}}:每轮生成一个新的随机值。
4. 列表:依次处理每一行与“没有更多”
- 依次处理每一行:某一行的元素在页面上命中多个(如表格每一行都有的按钮)时,在编辑器「命中多个元素时」选「依次每一行」。每一轮处理下一行;行被删除、重排后也能接着认出来,已禁用的行会跳过。
- 录制或点选列表里的按钮时,ClickRow 会按整个列表保存,而不是只认那一行的文字。页面浮动条会说明按哪种方式录制,并可一键在「列表第一行」与「依次处理每一行」之间切换。
- “没有更多”算正常结束:所有行都处理完,或至少完整跑完 1 轮后最后的「下一页」「加载更多」按钮已禁用或消失时,任务显示「已完成(没有更多)」,而不是报失败。
5. 快速填写与自动运行
- 快速填写:在输入框上点右键 →「用 ClickRow 快速填写」→「本字段」「本表单」或「整页」;也可以按 Alt+Shift+F(Mac:Ctrl+Shift+F)填写整页。字段会填入随机测试数据;密码、卡号、验证码一律不填。页面右下角会显示填了哪些、跳过了哪些,可「撤销」「再填一次」「存为任务」。不需要先建任务。
- 自动运行:在编辑器里打开「打开匹配的网页时自动运行」。ClickRow 只申请这些网站的访问权限(不会申请所有网站)。默认只填空字段,运行后页面上可「撤销本次填写」。含删除类点击、或运行时需要询问(
{{ask}})的任务不能自动运行——自动运行时可能没人确认或回答。
6. 运行记录
任务菜单「⋯」→「运行记录」可查看该任务最近 20 次运行:时间、耗时、轮数,失败的还有出错的行和原因。因“没有更多”而结束的运行、由自动运行启动的运行会单独标注。「跳到出错的那一行」会打开编辑器并展开那一行。只记时间、行号和原因码,从不记录输入内容;快速填写不是任务运行,不记录。「清空记录」可全部删除。
7. 快捷键
- Alt+Shift+G(Mac:Ctrl+Shift+G):运行当前网站上次用过的任务。
- Alt+Shift+S(Mac:Ctrl+Shift+S):停止正在运行的任务。
- Alt+Shift+F(Mac:Ctrl+Shift+F):快速填写整页。
可在 chrome://extensions/shortcuts 修改;若按键已被其它扩展占用,Chrome 会在那里显示为未设置。弹窗「设置」里可以看到当前按键。
8. 某一行失败了(错误码)
某一行失败时,ClickRow 会停下并说明原因、给出修复建议。每种原因有一个错误码,弹窗里的错误码会链接到这里。
| 错误码 | 含义 | 怎么办 |
|---|---|---|
NOT_FOUND | 找不到 该元素 | 等待超时仍未出现。页面可能还在加载,或布局变了。 |
NOT_VISIBLE | 该元素 不可见 | 元素在页面上但不可见,可能要先执行别的操作(打开菜单、标签页或弹窗),或稍等片刻。 |
COVERED | 该元素 被遮挡 | 有别的元素盖在它上面,点击会落到遮挡物上。 |
DISABLED | 该元素 处于禁用状态 | 页面可能要在必填项填好后才启用它。 |
VALUE_NOT_APPLIED | 该元素 的值没有生效 | 网站可能会改写或拒绝脚本输入的值。 |
NO_EFFECT | 点击 该元素 没有生效 | 网站可能忽略脚本点击,试试按屏幕位置点击或增加等待。 |
STILL_VISIBLE | 仍未消失 | 这一行等待消失的元素仍在页面上。页面可能需要更久才刷新,或上一行没有生效。 |
HOVER_NO_MENU | 悬停在 该元素 上没有打开菜单 | ClickRow 已把指针移到菜单按钮上(随后又尝试了键盘和点击),但菜单没有出现。有些网站只对真实鼠标展开这个菜单。请重新点选菜单按钮,或改为录制一次点击来打开菜单。 |
CUSTOM_DROPDOWN | 该元素 是自定义下拉框 | 它不是标准下拉框,可改为“点击展开 → 输入选项 → 按 Enter”。 |
NOT_EDITABLE | 该元素 无法输入文字 | 这个元素不是文本框。请重新点选输入框本身。 |
UNSUPPORTED_FIELD | 该元素 是 ClickRow 无法填写的字段类型 | 扩展无法填写文件选择等字段。请手动填写,或停用这一行。 |
UNSUPPORTED_KEY | ClickRow 无法按下这个按键 | 请使用 Enter、Tab、Escape、ArrowDown 或 Ctrl+A 这类按键名称。 |
ASK_REQUIRED | 该元素 需要在运行时手动输入 | 这一行使用了 {{ask}}。请重新运行,并在 ClickRow 询问时输入值——该值不会被保存。 |
FRAME_CROSS_ORIGIN | 该元素 位于其他网站的框架内 | ClickRow 只能操作同站的框架,请直接打开那个页面。 |
CANVAS_TARGET | 该元素 是画布或游戏区域 | ClickRow 只操作网页里的元素,不支持游戏或画布。 |
NAVIGATED_AWAY | 执行 该元素 时页面跳到了其他网站 | 任务离开开始时的网站后 ClickRow 会停止。 |
NAV_TIMEOUT | 执行 该元素 后下一页没有及时加载完 | ClickRow 最多等待 10 秒加载下一页,请检查页面后继续。 |
RESUME_FAILED | 执行 该元素 后无法在新页面继续 | 请刷新页面并重新点击 ClickRow 图标后继续。 |
CURSOR_UNAVAILABLE | 执行 该元素 时 ClickRow 无法保存运行进度 | ClickRow 无法保存运行进度,因此不能在下一页继续。请刷新页面后重新运行。 |
GOTO_CROSS_ORIGIN | 这一行“打开网址”会离开当前网站 | “打开网址”只能打开任务开始时所在网站的页面。请把网址改成本网站的页面。 |
GOTO_BAD_URL | 这一行“打开网址”的地址无效 | 请修改这一行的网址,例如 https://example.com/form 或 /form。 |
GOTO_BAD_PROTOCOL | 这一行“打开网址”的地址不受支持 | “打开网址”只能打开 http:// 或 https:// 页面。 |
UNSUPPORTED_STEP | 未知的行类型 | 这一行来自更新版本或其他版本的 ClickRow。请删除后重新添加。 |
ERROR | 这一行意外失败 | 页面上的某些情况导致这一行出错。请刷新页面后重试;如果反复出现,请重新点选元素。 |
ACTION_ERROR | 这一行意外失败 | 页面上的某些情况导致这一行出错。请刷新页面后重试;如果反复出现,请重新点选元素。 |
TAB_CLOSED | 运行中标签页被关闭 | 仅在运行记录中出现。运行结束前请保持标签页打开。 |
INTERRUPTED | 运行被中断 | 仅在运行记录中出现。页面被刷新或浏览器中止了运行,请重新运行任务。 |
9. 反馈问题
遇到问题或希望增加功能,请发邮件到 603356553@qq.com,说明你做了什么、看到了什么;请不要附上密码或个人信息。另见隐私政策。