element_setData
Update rendering data for custom components in WeChat Mini Programs using selector targeting to modify component states during development.
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 | ||
| data | Yes |
Implementation Reference
- src/tools/element.ts:210-234 (handler)Full tool object returned by createSetElementDataTool, including the execute handler that resolves the element using resolveElement, calls element.setData with the provided data, computes updated data keys, and returns a textual confirmation.
return { name: "element_setData", description: "设置组件实例渲染数据，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。", parameters: setElementDataParameters, execute: async (rawArgs, context: ToolContext) => { const args = setElementDataParameters.parse(rawArgs ?? {}); return manager.withPage( context.log, { overrides: args.connection }, async (page) => { const element = await resolveElement( page, args.selector, args.innerSelector ); await element.setData(args.data); const dataKeys = Object.keys(args.data ?? {}); return toTextResult( `已更新组件数据键: ${dataKeys.length ? dataKeys.join(", ") : "(无)"}。` ); } ); }, }; - src/tools/element.ts:41-45 (schema)Zod schema for tool parameters: connection container, selector (required string), optional innerSelector (string), and data (record of unknown).
const setElementDataParameters = connectionContainerSchema.extend({ selector: z.string().trim().min(1), innerSelector: z.string().trim().min(1).optional(), data: z.record(z.unknown()), }); - src/tools/element.ts:70-83 (registration)The createElementTools function registers the element_setData tool by including createSetElementDataTool(manager) in its returned array of 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), ]; - src/tools.ts:7-13 (registration)Top-level createTools function registers all tools, including element tools (thus element_setData) by spreading createElementTools(manager).
export function createTools(manager: WeappAutomatorManager): AnyTool[] { return [ ...createApplicationTools(manager), ...createPageTools(manager), ...createElementTools(manager), ]; }