Locators

Build tests

Use locators to give your steps stable element references. In AppraiseJS, the best path is usually route-aware capture through the Chromium picker, not typing selectors blind.

Job to be done: capture a selector that stays useful laterBest for: page-level UI interactionsRelated workflow: locator groups and test steps

Open Locator Groups Open Creating Tests

Workflow context

The locator creator matters because it sits between page discovery and durable test authoring. A good locator makes the case editor faster and the rerun more reliable.

Do this

UI path

Locators → Create → Launch Chromium Picker → Finalize Locator → Save

1. Open Locators -> Create.
2. Choose whether to launch from a saved environment or a direct URL.
3. Start the Chromium picker and navigate to the target page state if needed.
4. Click Start picking, select the element, review the proposed selector, then confirm it.
5. Review the autofilled locator name, selector value, route, and locator group suggestion.
6. Save the locator to an existing group or create a new route-aware group before saving.

Below is a screenshot of the locator creator in action.

Below is a screenshot of the locator picker in action.

Here is the complete flow of creating a locator.

Minimal example

• Group: Login Page
• Route: /login
• Locators: emailInput, passwordInput, submitButton, welcomeBanner

What good looks like

• The locator name is readable and specific.
• The selector is stable enough to survive layout changes.
• The locator group route matches the page where the step actually uses the selector.

Next step

Continue to Test Cases to see how locator references become executable steps.