Docs/Advanced Features

Global Locator Redirect

A global locator redirect rewrites every reference to a locator across every test in a project. Use it when a widely-shared element is renamed and you want one commit to update every caller instead of sweeping dozens of test files.

assrt.config.yamlyaml
locators:
  redirects:
    - from: "the sign in button"
      to: "the log in button"
    - from: "testid=checkout-cta"
      to: "testid=primary-checkout"
Redirects are a temporary bridge. Plan to search-and-replace them into test files and delete the config entries once the rename is stable.