mabl includes a "link crawler" plan and a corresponding test to "visit all linked pages within the app" by default. The plan is configured to run against all of your application environments every week.
If you opted the include credentials to access your application when you added the application, the link crawler will use those credentials to automatically log in to your application each time it runs at test.
You can change the configuration of the default link crawler plan(s) as you would any other plan.
mabl visits all linked pages within the domain by default
With no configuration, mabl will visit all linked pages within your domain. That means that if you configure an environment with URL https://app.example.com, mabl will visit not only pages within https://app.example.com (such as https://app.example.com/page1) but also any other pages that are linked to example.com within your app. Often, this results in mabl crawling documentation sites (https://docs.example.com) and marketing sites (https://www.example.com).
mabl will report links as broken for the following reasons:
- The landing page has a 404 error
- The page did not fully load while mabl was crawling it
- The page returned a non-2xx error such as a 503, 4xx, etc.
- The URL was already checked and marked as "broken" in the same run
Crawlable Content Types
Links are first validated with a
HEADrequest, ensuring a non-error HTTP status code is returned. Then, valid links are only loaded into the browser for further analysis and link crawling if the link returns one of the following content types:
By default, the mabl link crawler can accept an auto-login flow that will attempt to automatically login to your app before it begins to crawl links. In certain cases, the auto-login flow may not always be sufficient to complete authentication, such as cases where Captcha is present, or if there is more than just an email and password field.
In this case, a custom login flow is needed to properly crawl the app under test. To add one of these flows, simply duplicate the existing link crawler test. Once duplicated, view the steps list. You will have an option at the top to select a custom login flow. This can be any flow in your app, just make sure to select one that logs in properly.
This new link crawler can then be added to any plan, or run manually.
Updated 7 months ago