clearText
Remove text from the currently focused input field on mobile devices to automate testing and streamline data entry tasks.
Instructions
Clear text from the currently focused input field
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| platform | Yes | Platform of the device |
Implementation Reference
- src/server/interactionTools.ts:666-672 (registration)Registers the clearText tool in the ToolRegistry with name, description, schema, and handler function.
ToolRegistry.registerDeviceAware( "clearText", "Clear text from the currently focused input field", clearTextSchema, clearTextHandler, true // Supports progress notifications ); - src/server/interactionTools.ts:256-269 (handler)The registered handler for the clearText tool, which instantiates ClearText class and executes it.
const clearTextHandler = async (device: BootedDevice, args: ClearTextArgs, progress?: ProgressCallback) => { try { const clearText = new ClearText(device); const result = await clearText.execute(progress); return createJSONToolResponse({ message: "Cleared text from input field", observation: result.observation, ...result }); } catch (error) { throw new ActionableError(`Failed to clear text: ${error}`); } }; - Zod schema defining the input arguments for the clearText tool.
export const clearTextSchema = z.object({ platform: z.enum(["android", "ios"]).describe("Platform of the device") }); - src/features/action/ClearText.ts:16-54 (handler)Core execution logic of ClearText class, finds focused text field length and clears it by sending delete keyevents.
async execute(progress?: ProgressCallback): Promise<ClearTextResult> { return this.observedInteraction( async (observeResult: ObserveResult) => { try { if (!observeResult.viewHierarchy) { // Fallback: if we can't get view hierarchy, use a reasonable default await this.clearWithDeletes(200); return { success: true }; } let textLength = 0; // Look for focused elements first by traversing and checking attributes textLength = this.findFocusedElementTextLength(observeResult.viewHierarchy); // TODO: Move cursor to the end of the text if (textLength > 0) { await this.clearWithDeletes(textLength); } return { success: true }; } catch (error) { return { success: false, error: "Failed to clear text" }; } }, { changeExpected: false, // TODO: can only make this true once we know for sure there was text in the text field tolerancePercent: 0.00, timeoutMs: 100, progress } ); } - src/models/ClearTextResult.ts:6-10 (schema)TypeScript interface defining the return type of the clearText operation.
export interface ClearTextResult { success: boolean; observation?: ObserveResult; error?: string; }