mp_navigate
Navigate between pages in WeChat Mini Programs using methods like navigateTo, redirectTo, reLaunch, switchTab, and navigateBack for automated page transitions during development.
Instructions
在小程序内导航，支持 navigateTo、redirectTo、reLaunch、switchTab 和 navigateBack。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| connection | No | ||
| path | No | ||
| query | No | ||
| transition | No | navigateTo | |
| waitMs | No |
Implementation Reference
- src/tools/application.ts:109-175 (handler)The createNavigateTool function defines the 'mp_navigate' tool object, including its handler (execute function) that performs navigation in the mini-program using various transition types.function createNavigateTool(manager: WeappAutomatorManager): AnyTool { return { name: "mp_navigate", description: "在小程序内导航，支持 navigateTo、redirectTo、reLaunch、switchTab 和 navigateBack。", parameters: navigateParameters, execute: async (rawArgs, context: ToolContext) => { const args = navigateParameters.parse(rawArgs ?? {}); const transition = args.transition ?? "navigateTo"; const overrides = args.connection; const waitMs = args.waitMs; const providedPath = args.path; return manager.withMiniProgram<ContentResult>( context.log, { overrides }, async (miniProgram) => { let url: string | undefined; let page; if (transition === "navigateBack") { page = await miniProgram.navigateBack(); } else { if (!providedPath) { throw new UserError( "参数 path 是必需的，除非 transition 是 navigateBack。" ); } url = buildUrl(providedPath, args.query); switch (transition) { case "navigateTo": page = await miniProgram.navigateTo(url); break; case "redirectTo": page = await miniProgram.redirectTo(url); break; case "reLaunch": page = await miniProgram.reLaunch(url); break; case "switchTab": page = await miniProgram.switchTab(url); break; default: throw new UserError(`不支持的 transition: ${transition}`); } } if (waitMs && page) { await page.waitFor(waitMs); } const activePage = page ?? (await miniProgram.currentPage()); return toTextResult( formatJson({ transition, url, activePage: activePage ? { path: activePage.path, query: activePage.query } : null, }) ); } ); }, }; }
- src/tools/application.ts:24-38 (schema)Zod schema definition for the input parameters of the mp_navigate tool, extending connectionContainerSchema with path, query, transition, and waitMs.const navigateParameters = connectionContainerSchema .extend({ path: z.string().trim().min(1).optional(), query: querySchema, transition: z .enum([ "navigateTo", "redirectTo", "reLaunch", "switchTab", "navigateBack", ]) .default("navigateTo"), waitMs: z.coerce.number().int().nonnegative().optional(), });
- src/tools/application.ts:53-63 (registration)The createApplicationTools function registers the mp_navigate tool by including createNavigateTool(manager) in the array of tools returned.export function createApplicationTools( manager: WeappAutomatorManager ): AnyTool[] { return [ createEnsureConnectionTool(manager), createNavigateTool(manager), createScreenshotTool(manager), createCallWxMethodTool(manager), createGetConsoleLogsTool(manager), ]; }