page_getElements
Retrieve multiple page elements by CSS selector, returning an array with details such as index, tagName, text, and size. Supports limiting results and appending outer WXML.
Instructions
通过选择器获取页面元素数组，相当于 page.$$(selector)。返回 {selector,count,totalCount,limited,elements:[{index,tagName,text,value,size,offset}]}；limit 默认/最大 100，避免大页面一次汇总所有元素卡住连接；totalCount 是总命中数，count 是实际返回数。无匹配时返回 count:0 的空列表（不抛错，这是与会抛错的 page_getElement 的关键区别——批量/计数用本工具，单个必存在的元素用 page_getElement）。withWxml=true 给每个元素附完整 outerWxml。支持 selector[index=N]（0 基）只取第 N 个。⚠️ page.$$ 默认不穿透自定义组件（是否穿透取决于组件 styleIsolation/addGlobalClass，可用 page_getElements 看实际命中数判断）；组件内部元素用 element_getInnerElements，或 element_* 工具的 selector(组件)+innerSelector(内部)。结果超过 maxBytes（默认 50000B）返回截断包装。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| maxBytes | No | ||
| selector | Yes | ||
| withWxml | No | ||
| connection | No | 可选连接覆盖（不传则用默认会话）。可用字段：mode(launch|connect)、cliPath、projectPath、wsEndpoint、timeout、port(【自动化端口】→ cli auto --auto-port，默认 9420；不是 IDE HTTP 服务端口，别把 IDE 服务端口传进来)、account、ticket、trustProject、args、cwd、autoClose、autoLaunch、launchTimeout、connectTimeout。 |