element_callMethod
Execute specific methods on custom component instances in WeChat Mini Programs using selector targeting to trigger component behaviors and functionality.
Instructions
调用组件实例指定方法，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| connection | No | ||
| selector | Yes | ||
| innerSelector | No | ||
| method | Yes | ||
| args | No |
Implementation Reference
- src/tools/element.ts:28-33 (schema)Zod schema defining the input parameters: selector, optional innerSelector, method, and optional args array.const callElementMethodParameters = connectionContainerSchema.extend({ selector: z.string().trim().min(1), innerSelector: z.string().trim().min(1).optional(), method: z.string().trim().min(1), args: z.array(z.unknown()).optional(), });
- src/tools/element.ts:148-172 (handler)The execute handler: parses arguments, resolves the target element, invokes the specified method with given arguments on the element, and returns a JSON-formatted result including the method call details.execute: async (rawArgs, context: ToolContext) => { const args = callElementMethodParameters.parse(rawArgs ?? {}); return manager.withPage( context.log, { overrides: args.connection }, async (page) => { const element = await resolveElement( page, args.selector, args.innerSelector ); const callArgs = args.args ?? []; const result = await element.callMethod(args.method, ...callArgs); return toTextResult( formatJson({ selector: args.selector, innerSelector: args.innerSelector ?? null, method: args.method, arguments: callArgs, result: toSerializableValue(result), }) ); } );
- src/tools/element.ts:73-83 (registration)Registration within createElementTools: includes createCallElementMethodTool in the array of element tools.return [ createTapElementTool(manager), createInputTextTool(manager), createCallElementMethodTool(manager), createGetElementDataTool(manager), createSetElementDataTool(manager), createGetInnerElementTool(manager), createGetInnerElementsTool(manager), createGetElementSizeTool(manager), createGetElementWxmlTool(manager), ];
- src/tools.ts:7-13 (registration)createTools aggregates tools from modules, including element tools containing element_callMethod.export function createTools(manager: WeappAutomatorManager): AnyTool[] { return [ ...createApplicationTools(manager), ...createPageTools(manager), ...createElementTools(manager), ]; }
- src/index.ts:17-17 (registration)Top-level MCP server registration: adds all tools including element_callMethod via createTools.server.addTools(createTools(manager));