Recording Tests
The TestBrick Chrome extension records your browser interactions as test steps. Every click, keystroke, and navigation is captured automatically.
Install the extension
- Install the TestBrick Chrome Extension from the Chrome Web Store
- Sign in with your TestBrick account
- The extension icon appears in your browser toolbar
Start recording
- Open a UI test file in TestBrick
- Click Record in the toolbar
- 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:
- QA ID —
data-qa-id attribute (most reliable)
- Role + Name — semantic ARIA role (e.g., button “Submit”)
- Test ID —
data-testid attribute
- Label — associated form label
- Placeholder — input placeholder text
- CSS Selector — class/ID based
- 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.