Skip to main content

Your First Test

This guide walks you through the core ProvaLab.io workflow from start to finish: creating a test case, organizing it in a suite, executing it in a test run, and viewing the results. By the end, you will understand the fundamental testing cycle in ProvaLab.io.

Step 1: Create a Test Case​

A test case describes what to test and what the expected outcome should be.

  1. Open your project.

  2. Click Test Cases in the project navigation.

  3. Click + New Test Case.

  4. Fill in the basic details:

    • Title -- Write a clear, descriptive title. For example: "Verify user can log in with valid credentials".
    • Priority -- Select High (you can choose from Critical, High, Medium, or Low).
    • Type -- Select Functional (other options include Regression, Smoke, Integration, UI, API, and more).

  5. Add Preconditions -- What must be true before running this test:

    A registered user account exists. The user is not currently logged in.

  6. Add Test Steps -- For each step, enter the action and the expected result:

    StepActionExpected Result
    1Navigate to the login pageLogin form is displayed with email and password fields
    2Enter a valid email addressEmail is accepted with no validation errors
    3Enter the correct passwordPassword field shows masked characters
    4Click the Sign In buttonUser is redirected to the dashboard with a welcome message

  7. Click Save as Draft.

Your first test case is created.

tip

Good test case titles start with a verb and describe the expected behavior: "Verify user can...", "Confirm system displays...", "Validate error appears when...". This makes them easy to scan in a list.

Step 2: Add It to a Test Suite​

Test suites group related test cases together. Think of them as folders for your tests.

  1. Click Test Suites in the project navigation.
  2. Click + New Test Suite.
  3. Enter the details:
    • Name -- For example: "Login and Authentication".
    • Description -- "Tests covering user login, logout, and authentication flows."
  4. Click Create Suite.
  5. Open the suite you just created.
  6. Click Add Test Cases.
  7. Search for and select the test case you created in Step 1.
  8. Click Add Selected.

Your test case is now organized inside a suite.

info

You can add the same test case to multiple suites. For example, a login test might belong to both a "Login and Authentication" suite and a "Smoke Tests" suite.

Step 3: Create a Test Run​

A test run is an execution session where you (or your team) work through a set of test cases and record results.

  1. Click Test Runs in the project navigation (or in the left sidebar).
  2. Click + New Test Run.
  3. Fill in the details:
    • Name -- For example: "Sprint 1 Smoke Test - Staging".
    • Environment -- Select Staging (or whichever environment you are testing).
  4. Under Select Test Cases, choose Select Test Suite and pick the "Login and Authentication" suite.
  5. In the Assign To field, assign the run to yourself.
  6. Click Create Test Run.

Step 4: Execute the Test​

Now it is time to actually run the test and record what happens.

  1. Open the test run you just created.

  2. Click Start Execution.

  3. ProvaLab.io displays the first test case with all its steps and expected results.

  4. Follow each step on your application under test.

  5. Record the outcome:

    If the test passed:

    • Click the Pass button.
    • Optionally add a comment (e.g., "Verified on Chrome 120, Staging environment").
    • Click Next Test Case (or Complete Run if this is the only test).

    If the test failed:

    • Click the Fail button.
    • Enter the failure reason (required). For example: "Sign In button returned a 500 error."
    • Indicate which step failed.
    • Optionally attach a screenshot or log file by clicking Attach File.
    • Optionally click Log Defect to create a bug report directly.
    • Click Next Test Case.

    If the test was skipped or blocked:

    • Click Skip or Blocked.
    • Enter the reason. For example: "Staging environment is down for maintenance."
    • Click Next Test Case.

  6. After all test cases are executed, click Complete Run.

  7. Review the summary and click Finish.

tip

Use keyboard shortcuts during execution for speed: P for Pass, F for Fail, S for Skip, B for Blocked. See the full list in Keyboard Shortcuts.

Step 5: View the Results​

After completing the run, ProvaLab.io shows you a results summary.

  1. Go to Test Runs and click on your completed run.
  2. The summary shows:
    • Total Tests -- How many test cases were in the run.
    • Passed / Failed / Skipped / Blocked -- Counts and percentages for each status.
    • Duration -- How long the run took.
    • Pass Rate -- The overall percentage of tests that passed.
  3. Click on any individual result to see:
    • The status and which step failed (if applicable).
    • Comments and failure reasons.
    • Attached screenshots or files.
    • Who executed it and when.

What You Just Accomplished​

In these five steps, you experienced the core ProvaLab.io workflow:

  1. Created a test case with steps and expected results.
  2. Organized it in a test suite.
  3. Planned a test run.
  4. Executed the test and recorded the outcome.
  5. Reviewed the results.

This is the cycle you will repeat for every testing effort -- from smoke tests to full regression suites.

Next Steps​

Now that you know the basics, here are some recommended next steps: