Element Selector
Easily identify and target elements on any webpage to build reliable and dynamic workflows. Whether it’s a button, form, or specific text, this tool helps you pinpoint exactly what your web-agent needs to interact with.
Overview
Element Selector helps you precisely identify and interact with web elements in your automation workflows.
Key Features
-
Selection Methods
- Point and click
- CSS selectors
- XPath selection
- Text matching
-
Element Properties
- Attribute inspection
- State detection
- Dynamic content handling
- Frame support
-
Advanced Features
- Multiple element selection
- Relative positioning
- Shadow DOM support
- iFrame navigation
Best Practices
- Use specific selectors
- Handle dynamic content
- Verify selections
- Test across states
Basic Selection
-
Activate the Selector Click the selector icon in the builder toolbar to start targeting elements.
-
Hover and Click Move your mouse over the desired element. The selector will highlight elements as you hover.
-
Verify Selection Once clicked, the element’s details will appear in the builder panel.
Enhance Selector
The Enhance Selector feature helps you create more robust and reliable element selectors that can withstand website updates and dynamic content changes.
Create selectors that find elements based on their text content:
- Exact match: “Login”
- Partial match: “contains(Login)”
- Regular expressions for complex patterns
Create selectors that find elements based on their text content:
- Exact match: “Login”
- Partial match: “contains(Login)”
- Regular expressions for complex patterns
Target elements using their HTML attributes:
- ID: “#login-button”
- Class: “.btn-primary”
- Custom attributes: “[data-testid=‘submit’]”
Select elements based on their relationship to other elements:
- Parent/child relationships
- Siblings
- Nth occurrence of similar elements
Best Practices
Use Unique Identifiers
Prioritize IDs and unique attributes when available for most reliable targeting
Test Multiple Scenarios
Verify your selector works across different states and conditions
Keep it Simple
Start with the simplest selector that works reliably
Regular Testing
Periodically verify selectors still work as websites update
Troubleshooting
Remember to test your selectors thoroughly, especially when dealing with dynamic content or responsive layouts.