Skip to main content

Recording Tests

The TestBrick Chrome extension records your browser interactions as test steps. Every click, keystroke, and navigation is captured automatically.

Install the extension

  1. Install the TestBrick Chrome Extension from the Chrome Web Store
  2. Sign in with your TestBrick account
  3. The extension icon appears in your browser toolbar

Start recording

  1. Open a UI test file in TestBrick
  2. Click Record in the toolbar
  3. Navigate to your app — the extension starts capturing

What gets recorded

Locator strategies

Each recorded step captures multiple ways to find the element, in priority order:
  1. QA IDdata-qa-id attribute (most reliable)
  2. Role + Name — semantic ARIA role (e.g., button “Submit”)
  3. Test IDdata-testid attribute
  4. Label — associated form label
  5. Placeholder — input placeholder text
  6. CSS Selector — class/ID based
  7. XPath — full path (last resort)
During replay, TestBrick tries each strategy until one finds the element. This makes tests resilient to minor UI changes.

Stop recording

Click Stop Recording or close the extension popup. Your recorded steps appear in the test file.
Add data-qa-id attributes to important elements in your app for the most reliable test recordings.