Search

Home

What is Code Cube

Privacy & security

FAQ

Scenario Tester (beta)

Scenario Tester (beta)

This guide walks you through using the Scenario Tester. The Scenario Tester allows you to validate your configurations live on-screen before activating them. By simulating the execution path in real time, you can debug selectors, verify JSON objects, and fix configuration errors instantly. This saves time and ensures your background checks only go live when they are 100% correct. to validate your DataLayer Guard scenario configuration.

What will you do?

  • Launch the Scenario Tester from the portal
  • Select and run one or more scenarios
  • Monitor the livestream and step panel in real time
  • Review and export the results

⏰ Estimated time: 5–10 minutes

🔧 Requirements: Access to the Code-Cube.io portal and at least one configured scenario

How to use the Scenario Tester

Step 1: Open the Scenario Tester

Before running a test, navigate to the correct location in the portal so you can access the Scenario Tester window.

  1. Access the DataLayer Guard configurations page in the Code-Cube.io portal.
  2. Go to Monitoring via Page Scenarios.
  3. Click the Test scenario button.
image
💡 The Scenario Tester window will open after clicking Test scenario.

Step 2: Select a scenario and start the test

Choose which scenario(s) you want to validate. You can choose to run multiple scenarios, however, running a single scenario saves time when you are working on a specific part of your configuration.

  1. Click the dropdown in the top-left corner of the Scenario Tester window.
  2. Select one or more scenarios from the list. Leave it set to All scenarios to test every created scenario.
  3. Press the Start button.
⚠️ Important: The scenario selector is disabled while a test is running. Stop the test first if you need to change your selection.

Step 3: Monitor the test in real time

While the test runs, two panels at the bottom of the window give you a live view of progress and system activity.

  1. Watch the Live step panel (bottom-left) to see each step appear with a “pass” or “fail” status.
  2. Watch the Live logs panel (bottom-right) to see timestamped system messages and any errors.
  3. Monitor the livestream on the right side of the window to see the real-time DataLayer Guard actions in the browser.
image

Step 4: Review and export the results

Once the test finishes, the results panel appears automatically. You can inspect everything that was collected and validated.

  1. Review the summary badges at the top of the results panel:
    • X events collected: total number of dataLayer events found.
    • Y events have errors: number of events with validation errors.
  2. Click on any scenario to expand it and see:
    • Individual steps with their pass/fail status.
    • Collected dataLayer objects shown as formatted JSON.
    • For failed steps: a detailed error breakdown showing the expected value versus the actual value for each parameter.
  3. Export the results if needed:
    • Download PDF: exports a formatted PDF report.
    • Download Excel: exports the results as an XLSX file.

Interface & component breakdown

Scenario selector

Status indicator

Test statistics

Livestream

Live step panel

Live logs panel

Results panel

Troubleshooting

Issue
Likely cause
What to do
Livestream shows "Waiting for browser feed…" indefinitely
Browser connection failed to establish.
Stop the test and start it again. Check your network connection.

Error guide

Scenario Tester error guideScenario Tester error guide