element_getInnerElements
Retrieve elements within a specified component using CSS selectors to access and manipulate nested elements in WeChat mini program development.
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)Creates and returns the tool object for 'element_getInnerElements', including the execute handler that resolves a parent element and queries inner elements matching the target selector, returning their count and basic info (index, tagName, text).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 for the input parameters of the element_getInnerElements tool: connection, selector (parent), optional innerSelector, and targetSelector.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)Registers the element_getInnerElements tool by calling createGetInnerElementsTool and including it in the array returned by createElementTools.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), ]; }