testdriverelementslisted

<!-- Generated from elements.mdx. DO NOT EDIT. --> ## Overview TestDriver's element finding system uses AI to locate elements on screen using natural language descriptions. The `find()` method returns an `Element` object that you can interact with. ## Finding Elements ### find() Locate an element on screen using a natural language description. ```javascript const element = await testdriver.find(description) ``` **Parameters:** - `description` (string) - Natural language description of the element to find **Returns:** `Promise<Element>` - Element instance that has been located **Example:** ```javascript // Find a button const submitButton = await testdriver.find('the submit button'); // Find an input field with context const emailField = await testdriver.find('email input field in the login form'); // Find an element by visual characteristics const redButton = await testdriver.find('red button in the top right corner'); ``` <Tip> Be specific in your descriptions. Include visual details, location context, or nearby text to improve accuracy. </Tip> ## Element Class The `Element` class represents a located (or to-be-located) UI element. It provides methods for interaction and properties for element information. ### Methods #### found() Check if the element was successfully located. ```javascript element.found() ``` **Returns:** `boolean` - True if element coordinates were found **Example:** ```javascript const element = await testdriver.find('login button');