类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 谷歌填表类。
类型名必须写完整「谷歌填表类」。声明时自动创建，一般无需再调 创建*。
硬约束
- 类型名必须写「谷歌填表类」。Chrome 远程调试填表/点击/取数。
- 须先启动带调试端口的 Chrome 并连接成功。
- 方法调用必须带括号。
快速开始
谷歌填表类 g
// 连接 / 打开 / 填表：见下方命令介绍
谷歌填表类/创建
共 1 条。
创建谷歌填表
- 签名：
通用 创建谷歌填表() - 说明：创建一个谷歌填表会话（Chrome 远程调试 / CDP）。一般直接写「谷歌填表类 g」即可；「创建谷歌填表()」仅在需要显式赋值时使用。
谷歌填表类/属性
共 5 条。
超时
- 签名：
整数 超时 - 说明：当前超时毫秒数。
错误信息
- 签名：
文本 错误信息 - 说明：最近失败原因。
是否已连接
- 签名：
逻辑 是否已连接 - 说明：是否已连接（无括号属性）。
页面URL
- 签名：
文本 页面URL - 说明：当前页面 URL。
页面标题
- 签名：
文本 页面标题 - 说明：当前页面标题（勿与控件属性「标题」混淆）。
谷歌填表类/方法
共 40 条。
置超时
- 签名：
无 置超时([整数 毫秒=30000]) - 说明：设置连接与 CDP 命令超时（毫秒）。
- 参数一│[整数 毫秒=30000]: >0 生效；≤0 回退 30000。
置用户目录
- 签名：
无 置用户目录(文本 路径) - 说明：设置 Chrome –user-data-dir（启动前调用）。空则用临时目录。
- 参数一│文本 路径: 用户数据目录。
置缓存目录
- 签名：
无 置缓存目录(文本 路径) - 说明：设置 Chrome –disk-cache-dir（启动前调用）。
- 参数一│文本 路径: 磁盘缓存目录。
置浏览器路径
- 签名：
无 置浏览器路径(文本 路径) - 说明：指定 chrome.exe / msedge.exe 完整路径；空则自动查找。
- 参数一│文本 路径: 浏览器可执行文件。
置端口
- 签名：
无 置端口([整数 端口=9222]) - 说明：设置远程调试端口（连接/启动默认用此端口）。
- 参数一│[整数 端口=9222]: 调试端口。
置主机
- 签名：
无 置主机([文本 主机="127.0.0.1"]) - 说明：设置调试主机；仅本机才会自动启动浏览器。
- 参数一│[文本 主机=”127.0.0.1”]: 调试主机。
置框架
- 签名：
无 置框架([文本 框架选择器=""]) - 说明：指定后续 DOM 操作所在的 iframe/frame（CSS）。空=清除，恢复自动穿透。
- 参数一│[文本 框架选择器=”“]: 如 “iframe#main”、”frame[name=x]”；空清除。
清除框架
- 签名：
无 清除框架() - 说明：清除 置框架，恢复顶层+自动穿透。
取框架
- 签名：
文本 取框架() - 说明：当前 置框架 的选择器；未设置则为空文本。
取超时
- 签名：
整数 取超时() - 说明：取当前超时毫秒数。
启动
- 签名：
逻辑 启动() - 说明：仅启动本机 Chrome 调试口（不附着页面）。已就绪则直接成功。
启动浏览器
- 签名：
逻辑 启动浏览器() - 说明：同 启动()。
连接
- 签名：
逻辑 连接([整数 端口=0], [文本 主机=""]) - 说明：附着调试页。端口/主机省略时用 置端口/置主机。本机未开调试口会自动启动。成功后请用 打开(网址) 导航。
- 参数一│[整数 端口=0]: ≤0 用 置端口。
- 参数二│[文本 主机=”“]: 空则用 置主机。
连接调试地址
- 签名：
逻辑 连接调试地址(文本 调试URL) - 说明：直接连接已知 webSocketDebuggerUrl（高级）。
- 参数一│文本 调试URL: /json/list 中的 webSocketDebuggerUrl。
打开新标签
- 签名：
逻辑 打开新标签([文本 url="about:blank"], [整数 端口=9222], [文本 主机="127.0.0.1"]) - 说明：新建标签页并附着到该页；本机调试口未开时会自动启动浏览器。
- 参数一│[文本 url=”about:blank”]: 初始地址。
- 参数二│[整数 端口=9222]: 调试端口。
- 参数三│[文本 主机=”127.0.0.1”]: 调试主机。
断开
- 签名：
无 断开() - 说明：断开 CDP 连接。
重置
- 签名：
无 重置() - 说明：断开并清空错误；保留超时等配置。
是否已连接
- 签名：
逻辑 是否已连接() - 说明：是否已连接到调试页。
打开
- 签名：
逻辑 打开(文本 url) - 说明：导航到 URL 并等待加载完成（或超时）。
- 参数一│文本 url: 目标地址。
等待加载
- 签名：
逻辑 等待加载([整数 毫秒=0]) - 说明：等待 document.readyState 为 complete；毫秒≤0 用会话超时。
- 参数一│[整数 毫秒=0]: ≤0 使用 置超时 的值。
填入
- 签名：
逻辑 填入(文本 选择器, 文本 值) - 说明：向 CSS 选择器匹配的输入框填入文本（触发 input/change）。未置框架时：顶层优先，找不到再穿透同源 iframe；已置框架则只在该框架内。
- 参数一│文本 选择器: CSS 选择器。
- 参数二│文本 值: 要填入的内容。
全部填入
- 签名：
整数 全部填入(文本 选择器, 文本 值) - 说明：对 CSS 选择器全部匹配节点填入同一文本（querySelectorAll，规则同 填入 的框架穿透）。返回成功处理的个数。
- 参数一│文本 选择器: CSS 选择器。
- 参数二│文本 值: 每个匹配要填入的内容。
全部点击
- 签名：
整数 全部点击(文本 选择器) - 说明：点击选择器全部匹配节点；返回处理个数。
- 参数一│文本 选择器: CSS 选择器。
取匹配数
- 签名：
整数 取匹配数(文本 选择器) - 说明：返回选择器匹配到的节点个数。
- 参数一│文本 选择器: CSS 选择器。
取全部文本
- 签名：
文本 取全部文本(文本 选择器) - 说明：取全部匹配节点的可见文本，以换行拼接。
- 参数一│文本 选择器: CSS 选择器。
点击
- 签名：
逻辑 点击(文本 选择器) - 说明：点击 CSS 选择器匹配的元素（同 填入：支持自动穿透/置框架）。
- 参数一│文本 选择器: CSS 选择器。
取文本
- 签名：
文本 取文本(文本 选择器) - 说明：取元素 textContent（支持自动穿透/置框架）。
- 参数一│文本 选择器: CSS 选择器。
取值
- 签名：
文本 取值(文本 选择器) - 说明：取输入框 value。
- 参数一│文本 选择器: CSS 选择器。
是否存在
- 签名：
逻辑 是否存在(文本 选择器) - 说明：页面上是否存在该选择器元素。
- 参数一│文本 选择器: CSS 选择器。
等待出现
- 签名：
逻辑 等待出现(文本 选择器, [整数 毫秒=0]) - 说明：轮询直到元素出现或超时；毫秒≤0 用会话超时。支持框架穿透/置框架。
- 参数一│文本 选择器: CSS 选择器。
- 参数二│[整数 毫秒=0]: ≤0 使用 置超时。
框架填入
- 签名：
逻辑 框架填入(文本 框架选择器, 文本 选择器, 文本 值) - 说明：在指定 iframe/frame 内填入（一次性，不改 置框架）。
- 参数一│文本 框架选择器: iframe/frame 的 CSS。
- 参数二│文本 选择器: 框架内元素。
- 参数三│文本 值: 填入内容。
框架点击
- 签名：
逻辑 框架点击(文本 框架选择器, 文本 选择器) - 说明：在指定框架内点击。
- 参数一│文本 框架选择器: iframe/frame 的 CSS。
- 参数二│文本 选择器: 框架内元素。
框架取文本
- 签名：
文本 框架取文本(文本 框架选择器, 文本 选择器) - 说明：在指定框架内取 textContent。
- 参数一│文本 框架选择器。
- 参数二│文本 选择器。
框架取值
- 签名：
文本 框架取值(文本 框架选择器, 文本 选择器) - 说明：在指定框架内取 input value。
- 参数一│文本 框架选择器。
- 参数二│文本 选择器。
框架是否存在
- 签名：
逻辑 框架是否存在(文本 框架选择器, 文本 选择器) - 说明：指定框架内是否存在元素。
- 参数一│文本 框架选择器。
- 参数二│文本 选择器。
框架等待出现
- 签名：
逻辑 框架等待出现(文本 框架选择器, 文本 选择器, [整数 毫秒=0]) - 说明：等待指定框架内元素出现。
- 参数一│文本 框架选择器。
- 参数二│文本 选择器。
- 参数三│[整数 毫秒=0]。
执行
- 签名：
文本 执行(文本 表达式) - 说明：在页面执行 JS 表达式，结果转为文本返回。
- 参数一│文本 表达式: JavaScript 表达式。
取错误
- 签名：
文本 取错误() - 说明：最近一次失败原因。
取页面URL
- 签名：
文本 取页面URL() - 说明：当前页面 URL。
取标题
- 签名：
文本 取标题() - 说明：当前页面标题。
易错对照
| 错误 | 正确 |
|---|---|
| 未开调试端口 | Chrome 加远程调试参数后再连 |
| 类型写成「谷歌填表」 | 必须「谷歌填表类」 |