Actions are tasks that PageCrawl executes in the browser before taking a page snapshot. They let you automate interactions like dismissing cookie banners, clicking tabs, logging in, scrolling to load content, or waiting for dynamic elements to appear.
Actions are configured per tracked element and execute in order from top to bottom.
Where to Configure Actions
Open any monitored page and click Edit. In the page configuration form, find the Actions section. Click Add Action to add a new action, then select the action type from the dropdown.
Available Actions
Error Handling
| Action | What It Does |
|---|---|
| Mark as failed | Mark the check as failed when conditions are met (page inaccessible, contains specific text, etc.) |
Block and Hide
| Action | What It Does |
|---|---|
| Remove cookies | Automatically hide cookie consent banners |
| Remove overlays | Hide website overlays and popups |
| Remove dates | Replace dates with "[DATE REMOVED]" to prevent false positives |
| Remove element | Remove a specific element by CSS or XPath selector |
| Remove text | Remove elements containing specific text |
Wait
| Action | What It Does |
|---|---|
| Wait for text | Wait up to 15 seconds for specific text to appear on the page |
| Wait for text to disappear | Wait up to 15 seconds for specific text to disappear |
| Wait for element | Wait for an element (by XPath or CSS selector) to appear |
| Wait for redirect | Wait for the page to redirect to a new URL |
| Wait | Pause for a specified number of seconds |
Interact
| Action | What It Does |
|---|---|
| Click button | Click a button element |
| Click element | Click any element by selector |
| Click at coordinates | Click at specific X/Y pixel coordinates |
| Hover | Hover over an element |
| Type text | Type text into an input field |
| Select option | Select an option from a dropdown |
| Submit form | Submit a form |
| Scroll to bottom | Scroll the page to the bottom (useful for lazy-loaded content) |
| Go back | Navigate back in browser history |
| Show hidden elements | Force hidden elements to be visible |
Advanced
| Action | What It Does |
|---|---|
| Disable JavaScript | Disable JavaScript before the page loads |
| Set cookie | Set or manage browser cookies |
| Execute JavaScript | Run custom JavaScript code on the page |
| Handle CAPTCHA | Interact with CAPTCHA challenges |
Common Use Cases
Dismiss cookie banners: Add a "Remove cookies" action to automatically hide consent popups that can trigger false change notifications.
Load lazy content: Add "Scroll to bottom" followed by "Wait" (2-3 seconds) to load content that only appears when scrolling.
Navigate to a tab or section: Add a "Click element" action with the CSS selector of the tab you want to monitor.
Login to a page: Add "Type text" actions for username and password fields, followed by "Click button" to submit the login form.
Wait for dynamic content: Add "Wait for text" with the text that appears after the page finishes loading (e.g., "Showing results").
