testdriverlocating-elementslisted

<!-- Generated from locating-elements.mdx. DO NOT EDIT. --> ## Overview The TestDriver element finding system uses AI. It finds elements on the screen with natural language descriptions. The `find()` method returns an `Element` object. You can [interact with the object](/interacting-with-your-app). ## Finding Elements ### find() Find an element on the screen with a natural language description. ```javascript const element = await testdriver.find(description) ``` **Parameters:** - `description` (string) - A natural language description of the element to find **Returns:** `Promise<Element>` - The Element instance that TestDriver found **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 make the accuracy better. </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. For interaction methods like `click()` and `hover()`, see [Interacting With Your App](/interacting-with-your-app). ### Methods #### found() Check if the element was successfully located.