By default, browser tests use the Datadog locator system. It is recommended to only use custom selectors in edge cases as the Datadog locator system is what allows tests to be self-maintaining.
Custom selectors are created by performing a step of interest in the recorder (click, hover, assert, etc.) on any element of your page. This specifies the kind of step that needs to be performed.
To specify your custom locator:
By default the box If user specified locator fails, fail test is selected. This means that, by default, if the defined locator fails, the test is considered a failure.
You can decide to fall back on the regular browser test algorithm by deselecting the If user specified locator fails, fail test box.
If a browser test is not able to locate an element, by default it retries the step for 60 seconds.
You can decide to decrease or increase this time out up to 300 seconds if you want your test to wait for less or more time to be able to find the step targeted element.
In some cases, such as in the event of a pop-up, you may want to make some steps optional. To configure this option, select Allow this step to fail. If the step fails after the amount of minutes specified on the timeout option (60 seconds by default), then the test will move on and execute the next step.
You can prevent a step screenshot from being captured at test execution. This is helpful to ensure no sensitive data gets featured in your test results. Use mindfully as it can make failure troubleshooting more difficult. Read more about security recommendations here.
Note: This feature is also available at the global test level, as an advanced option in your browser test configuration.
Subtests advanced options also allow you to choose where you want your subtest to be played:
Opening your subtest in the main window means that your subtest is the continuation of your main test as it uses the URL from the previous step. Opening your subtest in a new window, or in a specific window, means that the test starts running from the subtest start URL.
Additional helpful documentation, links, and articles: