diff --git a/content/en/synthetics/browser_tests/_index.md b/content/en/synthetics/browser_tests/_index.md index 1cd9adcee5e8b..1f1bdfe7bfc5b 100644 --- a/content/en/synthetics/browser_tests/_index.md +++ b/content/en/synthetics/browser_tests/_index.md @@ -43,7 +43,7 @@ You may create a test using one of the following options: {{< img src="/synthetics/browser_tests/synthetics_templates_browser.mp4" alt="Video of Synthetics Browser Test landing page with templates" video="true" >}} ### Build a test from scratch - + 1. Click the **+** template to start a new Browser Test from scratch. 1. Enter a **Starting URL**: The URL from which your browser test starts the scenario. 1. Add a **name**: The name of your browser test. @@ -226,6 +226,74 @@ You can switch tabs in a browser test recording in order to perform an action on Datadog recommends ending your browser test with an **[assertion][12]** to confirm the journey executed by the browser test resulted in the expected state. 6. Once you have finished your scenario, click **Save and Launch Test**. +## Step replay + +Step replay allows you to re-run one or more steps of your browser test directly from the Datadog Synthetic Monitoring Chrome extension. This feature helps you establish the correct state when adding or editing steps in the middle of a long test, so you don't need to manually replay the entire test from the beginning. + +
+

The current version of the extension does not have Chrome's debugger permission, as a result:

+ +
+ +### How to use step replay + +You can replay steps in three ways: + +1. Single step replay: Re-execute a single step: +{{< img src="synthetics/browser_tests/recording__replay--replay-one-step.mp4" alt="Single Step Replay" video="true" height="400px" >}} +

Hover over the step, and click on the play button to replay only this step.

+ +2. Replay all steps: Run the entire sequence of steps as defined in the recorder: +{{< img src="synthetics/browser_tests/recording__replay--replay-all-steps.mp4" alt="Replay All Steps" video="true" height="400px" >}} +

Click on the replay all icon (⏩︎) on top of the step list to replay all steps.

+ +3. Replay selected steps: Run a subset of steps you select in the step list: +{{< img src="synthetics/browser_tests/recording__replay--replay-selected-steps.mp4" alt="Replay Selected Steps" video="true">}} +

Select the steps you want to replay then click on the replay selected icon (⏩︎) on top of the step list.

+ +### Step replay feature support + +The following table summarizes which Browser Test step types are supported by step replay: + +| Step type | Supported by Step Replay | Notes | +|--------------------------|:------------------------:|-------| +| Extract variable | {{< X >}} | | +| Go to URL | {{< X >}} | | +| Refresh | {{< X >}} | | +| Scroll | {{< X >}} | | +| Select option | {{< X >}} | | +| Wait | {{< X >}} | | +| Assert checkbox state | {{< X >}} | | +| Assert current URL | {{< X >}} | | +| Assert element attribute | {{< X >}} | | +| Assert element content | {{< X >}} | | +| Assert element present | {{< X >}} | | +| Assert file download | {{< X >}} | | +| Assert page contains | {{< X >}} | | +| Assert page lacks | {{< X >}} | | +| Click | {{< X >}}* | *Click steps are supported, but may behave differently than in a full Synthetic Monitoring test run. | +| Hover | {{< X >}}* | *Hover steps are supported, but may behave differently than in a full Synthetic Monitoring test run. | + +### Step types not supported by step replay + +| Step type | Supported by step replay | +|--------------------------|:------------------------:| +| Assert email | Not supported | +| Assert requests | Not supported | +| Extract from email body | Not supported | +| Go to email link | Not supported | +| Upload files | Not supported | +| Assert natural language | Not supported | +| Run API test | Not supported | +| Assert from JavaScript | Not supported | +| Extract from JavaScript | Not supported | +| Press key | Not supported | +| Type text | Not supported | + ## Permissions By default, only users with the [Datadog Admin and Datadog Standard roles][15] can create, edit, and delete Synthetic browser tests. To get create, edit, and delete access to Synthetic browser tests, upgrade your user to one of those two [default roles][15]. diff --git a/static/images/synthetics/browser_tests/recording__replay--replay-all-steps.mp4 b/static/images/synthetics/browser_tests/recording__replay--replay-all-steps.mp4 new file mode 100644 index 0000000000000..0d5bc6a51e595 Binary files /dev/null and b/static/images/synthetics/browser_tests/recording__replay--replay-all-steps.mp4 differ diff --git a/static/images/synthetics/browser_tests/recording__replay--replay-one-step.mp4 b/static/images/synthetics/browser_tests/recording__replay--replay-one-step.mp4 new file mode 100644 index 0000000000000..672bf3fa992ab Binary files /dev/null and b/static/images/synthetics/browser_tests/recording__replay--replay-one-step.mp4 differ diff --git a/static/images/synthetics/browser_tests/recording__replay--replay-selected-steps.mp4 b/static/images/synthetics/browser_tests/recording__replay--replay-selected-steps.mp4 new file mode 100644 index 0000000000000..aafb11ea780e3 Binary files /dev/null and b/static/images/synthetics/browser_tests/recording__replay--replay-selected-steps.mp4 differ