element_getInnerElement
Retrieve elements within custom components in WeChat Mini Programs by first locating the component with an ID selector, then accessing its internal elements for automation tasks.
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:242-287 (handler)The execute handler function for the 'element_getInnerElement' tool. It resolves the parent element, queries the inner element using element.$(targetSelector), extracts tagName, text, and outerWxml, and returns them in JSON format.
execute: async (rawArgs, context: ToolContext) => { const args = getInnerElementParameters.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 innerElement = await element.$(args.targetSelector); if (!innerElement) { throw new UserError( `在元素 "${args.selector}" 内未找到选择器 "${args.targetSelector}" 对应的元素。` ); } const tagName = innerElement.tagName || null; const text = typeof innerElement.text === "function" ? await innerElement.text().catch(() => null) : null; const outerWxml = typeof innerElement.outerWxml === "function" ? await innerElement.outerWxml().catch(() => null) : null; return toTextResult( formatJson({ parentSelector: args.selector, parentInnerSelector: args.innerSelector ?? null, targetSelector: args.targetSelector, tagName: toSerializableValue(tagName), text: toSerializableValue(text), outerWxml: toSerializableValue(outerWxml), }) ); } ); }, - src/tools/element.ts:47-51 (schema)Zod schema defining the input parameters for the tool: selector (required), innerSelector (optional), targetSelector (required).
const getInnerElementParameters = connectionContainerSchema.extend({ selector: z.string().trim().min(1), innerSelector: z.string().trim().min(1).optional(), targetSelector: z.string().trim().min(1), }); - src/tools.ts:7-13 (registration)Top-level registration in createTools where createElementTools (containing element_getInnerElement) is included in the full tools array.
export function createTools(manager: WeappAutomatorManager): AnyTool[] { return [ ...createApplicationTools(manager), ...createPageTools(manager), ...createElementTools(manager), ]; } - src/tools/element.ts:70-84 (registration)Registration of the tool creator function createGetInnerElementTool within the element tools group.
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), ]; }