testdriverlocating-elementslisted
Install: claude install-skill testdriverai/testdriverai
<!-- Generated from locating-elements.mdx. DO NOT EDIT. -->
## Locating Single Elements
Use natural language to describe elements. Descriptions should be specific enough to locate the element, but not too-specific that they break with minor UI changes. For example:
```javascript
await testdriver.find('email input field');
await testdriver.find('first product card in the grid');
await testdriver.find('dropdown menu labeled "Country"');
```
<Info>TestDriver will cache found elements for improved performance on subsequent calls. Learn more about [element caching here](/v7/caching).</Info>
## Debugging Found Elements
After finding an element, you can inspect its properties for debugging:
```javascript
const button = await testdriver.find('submit button');
console.log(button);
```
This outputs all element properties:
```javascript
{
description: 'submit button',
found: true,
x: 150,
y: 300,
coordinates: { x: 150, y: 300, centerX: 200, centerY: 320 },
threshold: 0.8,
confidence: 0.95,
similarity: 0.92,
selector: 'button[type="submit"]',
cache: {
hit: true,
strategy: 'pixel-diff',
createdAt: '2025-01-15T10:30:00Z',
diffPercent: 0.02,
imageUrl: 'https://...'
}
}
```
## Working with Multiple Elements
Find and interact with multiple elements:
```javascript
// Find all matching elements
const products = await testdriver.findAll('product card');
console.log(`Found ${products.length} products`);
// Interact with each
for (const produc