← ClaudeAtlas

testdriverfindlisted

Locate UI elements using natural language
testdriverai/testdriverai · ★ 243 · Testing & QA · score 72
Install: claude install-skill testdriverai/testdriverai
<!-- Generated from find.mdx. DO NOT EDIT. --> ## Overview Find UI elements on the screen with natural language descriptions and AI. This returns an `Element` object. You can interact with the object. ## Syntax ```javascript const element = await testdriver.find(description) const element = await testdriver.find(description, options) ``` ## Parameters <ParamField path="description" type="string" required> Natural language description of the element to find </ParamField> <ParamField path="options" type="object | number"> Optional configuration for finding and caching <Expandable title="properties"> <ParamField path="cacheKey" type="string"> A custom cache key to store the element location. Use this to keep the cache clean when you use dynamic variables in prompts. You can also use it to share the cache between tests. </ParamField> <ParamField path="cacheThreshold" type="number" default={0.05}> The similarity threshold (0-1) for a cache match. A lower value needs more similarity. Set it to -1 to disable the cache. </ParamField> <ParamField path="timeout" type="number" default={10000}> The maximum time in milliseconds to poll for the element. TestDriver tries again each 5 seconds until it finds the element or the timeout ends. The default is `10000` (10 seconds). Set it to `0` to disable the poll and try one time. </ParamField> <ParamField path="confidence" type="number"> The minimum confidence th