Debugging with logs
Sometimes Trakr encounters issues when it attempts to capture screenshots or performing a visual test. This can be caused by a number of factors.
Trakr automatically excludes the screenshots with errors from visual testings.
Viewing the logs
You can access the logs for a screenshot collection or visual test from the menu.
Normally, if everything goes well, you should see something that looks like:
One of the hints that you might be having issues with your screenshots or tests is an error screenshot captured as part of a screenshot collection.
The error log
If Trakr encountered one or more errors, clicking “View logs” will provide you with more details. There are 3 parts to each of the items in the log.
- The URL/Breakpoint that Trakr had encountered the issue on. It’s possible that Trakr only encountered the error only on the specific breakpoint of the URL.
- The error message that provides clues on what happened
Common errors/fixes
- Error
Timeout while trying to get URL [http://www.example.com] - Cause
Trakr has a 30 seconds page timeout which means this error will occur if it is unable to capture a screenshot within this time period. This commonly occurs if your server cannot handle the simultaneous load (e.g. development server) or latency between Trakr resources and your server. - Potential fix
You can try the throttle performance option when taking screenshots for your project.
- Error
Timeout trying to locate element [.css-selector] - Cause
Trakr is unable to find the targeted element. This is normally related to the page interaction feature where the user either supplied an inaccurate CSS selector or the element does not exist for that page/breakpoint. - Potential fix
Check your page interaction configurations and test the CSS selector.
Please drop us an email if you consistently encounter errors that cannot be resolved.