element_getInnerElements
Retrieve multiple elements within a specified component in WeChat Mini Programs using CSS selectors for automated testing and development workflows.
Instructions
在元素范围内获取元素数组，相当于 element.$$(selector)。重要：操作自定义组件内部元素时，必须先通过 ID 选择器(如 #my-component)定位自定义组件，然后使用此工具获取组件内部的元素数组。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| connection | No | ||
| selector | Yes | ||
| innerSelector | No | ||
| targetSelector | Yes |
Implementation Reference
- src/tools/element.ts:291-348 (handler)The main handler for 'element_getInnerElements' tool. It parses arguments, resolves the parent element, checks if $$ method is available, queries inner elements with targetSelector, extracts tagName and text for each, and returns formatted JSON with parent info, count, and elements details.
function createGetInnerElementsTool(manager: WeappAutomatorManager): AnyTool { return { name: "element_getInnerElements", description: "在元素范围内获取元素数组，相当于 element.$$(selector)。重要：操作自定义组件内部元素时，必须先通过 ID 选择器(如 #my-component)定位自定义组件，然后使用此工具获取组件内部的元素数组。", parameters: getInnerElementsParameters, execute: async (rawArgs, context: ToolContext) => { const args = getInnerElementsParameters.parse(rawArgs ?? {}); return manager.withPage( context.log, { overrides: args.connection }, async (page) => { const element = await resolveElement( page, args.selector, args.innerSelector ); if (typeof element.$$ !== "function") { throw new UserError( `元素 "${args.selector}" 不支持查询内部元素数组。` ); } const innerElements = await element.$$(args.targetSelector); if (!Array.isArray(innerElements)) { throw new UserError( `在元素 "${args.selector}" 内查询选择器 "${args.targetSelector}" 失败。` ); } const elementsInfo = await Promise.all( innerElements.map(async (el, index) => { const tagName = el.tagName || null; const text = typeof el.text === "function" ? await el.text().catch(() => null) : null; return { index, tagName: toSerializableValue(tagName), text: toSerializableValue(text), }; }) ); return toTextResult( formatJson({ parentSelector: args.selector, parentInnerSelector: args.innerSelector ?? null, targetSelector: args.targetSelector, count: innerElements.length, elements: elementsInfo, }) ); } ); }, }; } - src/tools/element.ts:53-57 (schema)Zod schema defining the input parameters for the tool: selector (required), innerSelector (optional), targetSelector (required), extending shared connectionContainerSchema.
const getInnerElementsParameters = connectionContainerSchema.extend({ selector: z.string().trim().min(1), innerSelector: z.string().trim().min(1).optional(), targetSelector: z.string().trim().min(1), }); - src/tools/element.ts:70-84 (registration)Registration of the 'element_getInnerElements' tool via createGetInnerElementsTool(manager) within the exported createElementTools function that returns all element-related tools.
export function createElementTools( manager: WeappAutomatorManager ): AnyTool[] { return [ createTapElementTool(manager), createInputTextTool(manager), createCallElementMethodTool(manager), createGetElementDataTool(manager), createSetElementDataTool(manager), createGetInnerElementTool(manager), createGetInnerElementsTool(manager), createGetElementSizeTool(manager), createGetElementWxmlTool(manager), ]; }