Docs/Advanced Features

Auto-healing

Auto-healing retries a failing locator against the current DOM and, if a confident replacement exists, updates the step so the next run uses it. The goal is to absorb cosmetic UI changes that would otherwise cause flakes.

Turn it on

assrt.config.yamlyaml

autoHeal:
  enabled: true
  mode: suggest   # or "apply"
  reportTo: ./assrt-results/heal.json

suggest: record a proposed fix but do not change the test file.
apply: write the fix back to the source file automatically.

Review every applied heal

Auto-apply is convenient but can mask real regressions. Route the heal report into a PR or dashboard so changes get eyes on them before they land on main.