Skip to main content
What happens:
Tests become semantically unclear or are misinterpreted.
Bad example:A verify step that mixes in a click actionGood example:Separate action and verify steps written correctlyRule of thumb:
  • Actions = things the test does (e.g., click, scroll)
  • Verifications = things the test checks (e.g., visible, present)
Keep them in separate steps.
What happens:
Static tests placed inside a scenario table suite will execute once per scenario row, potentially causing duplicate confirmations or side effects.
Bad example:A static test placed inside a scenario table suiteGood practice:
Keep tests that do not rely on scenario table variables in a separate test or suite. This prevents static verifications from running multiple times.
What happens:
Spur can’t interpret Go to URL commands mid-test, causing scripts to fail.
Bad example:A Go to URL command written mid-testGood example:
  1. Set the Start URL in your test’s settings: Setting the Start URL in the test settings
  2. Use actions for in-test navigation: Using actions for in-test navigation
What happens:
Tests may break or misinterpret intent if you attempt to change tabs or navigate the browser without using supported actions.
What to do:
Use browser action steps for any tab or navigation changes. For example:
A browser action step used for tab navigationOr set the navigation using Browser Actions.
Always use the documented browser actions component for tab switches, window focus, and URL navigations.
What happens:
The agent only interacts with elements in view unless instructed otherwise. Tests may fail to locate off-screen elements.
What to do:
Explicitly include scroll steps before verifications or actions. For example:
A scroll step added before a verificationThe agent will also scroll to find out-of-viewport items, but specifying scrolls improves test stability. See Supported Actions: Scroll.
Remember that the agent sees only what a human sees. Include scroll instructions to ensure consistent element visibility.
What happens:
Direct navigation to restricted domains (e.g., spurmail.com, Spur’s built-in test inbox domain) may be blocked due to IP restrictions.
What to do:
Access these domains through the Preview Editor. The Preview Editor proxies your requests through Spur’s infrastructure, so IP blocks don’t apply. When you run the test normally, the agent’s requests go through the same proxy and the steps execute successfully.
Use the Preview Editor to interact with spurmail.com. Direct browser access may show a blocked IP error, but tests will pass when executed through the Preview Editor.

Authoring do’s & don’ts