Package com.smartgwt.client.docs

# Interface ObtainingLocators

public interface ObtainingLocators

### Obtaining locators

A locator is a stable, framework-generated string that uniquely identifies a UI component or DOM element in an application.

Ways to obtain locators

1. Developer Console ? Open the console, enable "Show AutoTest Locators", then click a UI element to see its locator. Copy it from the console.
2. Locator shortcut script ? Run a helper script like `AutoTest.installLocatorShortcut()`, then click an element while holding modifier keys to copy its locator to the clipboard.

Resolving locators

Use APIs like `AutoTest.getElement()` or `AutoTest.waitForElement()` to convert a locator back to a DOM element, with optional waiting for asynchronous operations to finish.