mp_currentPage
Retrieve current page path, query, size, and scroll position from a WeChat mini-program. Optionally extract specific data fields to capture a snapshot of page state for debugging or automation.
Instructions
获取当前页面信息(path、query、size、scrollTop)。withData=true 额外返回 page.data。
何时用:想一次拿“路由 + 尺寸/滚动 + 部分 data”的概览时。 何时改用别的:只想读 data 字段 → 用 page_getData;想断言/等待某个路由 → 用 page_expectRoute / page_waitRoute(它们已替你处理路由滞后),不要在这里读 path 再手动比较。
⚠️ 路由滞后:path 来自 SDK currentPage() 句柄,是快照型,仅在“刚做完快速 navigate / reLaunch / switchTab 的那一瞬间”可能落后于真实路由;稳态下可信。刚导航完一般不用调本工具——mp_navigate 返回的 activePage 已经可信。只有在确实怀疑该瞬间滞后时,才用 mp_evaluate 跑 return getCurrentPages().slice(-1)[0].route 交叉校验,别默认每次都加这步。
参数:dataPaths 只取关键字段、避免大数组爆 token,支持点路径、数组下标(含负数如 [-1])、.length、以及通配 [*](如 ['conversationHistory[*].aiStatus','isSearching']);解析不到的路径会进返回里的 missingPaths。maxBytes 默认 50000,超出按字节截断并置 truncated=true,字节数见 bytes(字段名与 page_getData 一致)。connection 可选。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxBytes | No | ||
| withData | No | ||
| dataPaths | 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。 |